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1 Einleitung und Grundlagen 



1.1 Vorbemerkungen 

Java wird heute als sehr gut geeignete Programmiersprache für 
große Internet- und Intranet-Anwendungen insbesondere auf der 
Serverseite eingesetzt. Die Plattformunabhängigkeit, reichhaltige 
Klassenbibliotheken und die Unterstützung zahlreicher APIs 
(Application Programming Interfaces) macht Java zur bevorzug- 
ten Sprache für verteilte Anwendungen in einem heterogenen 
Umfeld. 

Das vorliegende Buch beschäftigt sich mit der Implementierung Zielsetzung 
von Client/Server-Anwendungen auf Basis der Internet- 
Protokolle. Angesichts des Umfangs der Themen musste eine 
Auswahl getroffen werden, die auch in einem vier Semesterwo- 
chenstunden umfassenden Kurs behandelt werden kann. 

Ziel des Buches ist es, über die Themenvielfalt angemessen zu 
informieren und in die Einzelthemen systematisch mit der nöti- 
gen Tiefe einzuführen. Besonderer Wert wurde dabei auf praxis- 
nahe Programmbeispiele und Übungsaufgaben gelegt. 

Dieses Buch gliedert sich in acht Kapitel, die jeweils einen Aiißjau des Buches 
Schwerpunkt behandeln. Obwohl die Kapitel weitestgehend in 
sich geschlossen sind und unabhängig voneinander bearbeitet 
werden können, wird empfohlen, diese in der hier vorgegebe- 
nen Reihenfolge durchzuarbeiten. Die vorgestellten Themen 
werden anhand vollständiger, lauffähiger Programmbeispiele 
verdeutlicht. Übungsaufgaben am Ende eines jeden Kapitels 
sollen zur selbständigen Beschäftigung mit dem dargebotenen 
Stoff anregen. 

Das Buch hat folgende Kapitel: 

1 Einleitung und Grundlagen 

Dieses Kapitel gibt eine theoretische Einführung in die verteil- 
te Verarbeitung auf der Basis des Client/Server-Modells und 
stellt mehrstufige Architekturen vor. Sinn und Zweck von 
Middleware werden an einem ersten Programmbeispiel erläu- 
tert. Hier werden auch grundlegende Begriffe des Internets 
(wie IP-Adressen, Adressauflösung), die zum Verständnis der 
übrigen Kapitel nötig sind, erklärt. 

2 Datenbankanwendungen mit JDBC 

In mehrstufigen Architekturen verteilter Systeme, so z.B. bei 
dynamischen Wehanwendungen, erzeugt der Applikations- 
server Datenbankabfragen und schickt sie zur Ausführung an 
den Datenbankserver. JDBC ist das Standard-API für den 
Zugriff auf relationale Datenbanken mittels SQL-Anwei- 
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sungen, die zur Laufzeit dynamisch aufgebaut werden kön- 
nen. Wir beschäftigen uns mit den Grundlagen von JDBC, die 
interessante Client/Server-Anwendungen in den folgenden 
Kapiteln ermöglichen. Ein Exkurs zeigt, wie das Ergebnis ei- 
ner SQL-Abfrage in ein XML- bzw. HTML-Dokument trans- 
formiert werden kann. Ein weiterer Exkurs gibt eine kurze 
Einführung in die JDBC-Schnittstelle zu Stored Procedures am 
Beispiel von MySQL. 

3 Verbindungslose Kommunikation mit UDP 

Das User Datagram Protocol (UDP) ist neben TCP ein wichti- 
ges Transportprotokoll im Internet. Es ermöglicht, mit gerin- 
gem Aufwand Datenpakete zu versenden, ohne vorher eine 
Verbindung zum Empfänger aufbauen zu müssen. Wir entwi- 
ckeln u.a. ein Programm, mit dem zwei Benutzer an ver- 
schiedenen Rechnern im Netz eine Unterhaltung online füh- 
ren können. 

4 Client/Server-Anwendungen mit TCP 

Fast alle Internet-Dienste nutzen das Transmission Control 
Protocol (TCP). Im Gegensatz zu UDP stellt TCP eine verläss- 
liche Ende-zu-Ende-Verbindung zwischen Sender und Emp- 
fänger her. Der Anwendungsentwickler muss sich bei der 
Übertragung eines Datenstroms nicht um die Aufteilung in 
einzelne Pakete kümmern. Sockets sind die Endpunkte einer 
TCP-Verbindung. Sie ermöglichen es, das Senden und Emp- 
fangen von Daten wie das Schreiben und Lesen von Dateien 
zu behandeln. Multithreading versetzt den Server in die Lage, 
mehrere Client-Anfragen gleichzeitig zu bearbeiten. Wir ent- 
wickeln u.a. ein Dateiübertragungsprogramm sowie eine An- 
wendung, mit der ein so genanntes "Chatten" innerhalb einer 
Gruppe von Teilnehmern möglich ist. Der Einsatz wiederver- 
wendbarer Threads eines Tbread-Pools reduziert den Res- 
sourcenverbrauch und kann die Effizienz der Anwendung er- 
höhen. Das Kapitel wird mit der Vorstellung eines Frame- 
works für TCP-Server abgeschlossen. 

5 Implementierung eines HTTP-Servers 

Dieses Kapitel behandelt die Grundlagen des Anwendungs- 
protokolls Hypertext Transfer Protocol (HTTP), das die Kom- 
munikationsfunktionalität des World Wide Web definiert. 
HTTP verwendet auf der Transportschicht TCP. Wir imple- 
mentieren u.a. einen speziellen HTTP-Server, der beliebige 
SQL-Anweisungen vom Webbrowser entgegennimmt und 
ausführt, sowie einen einfachen Webserver zur Übertragung 
von statischen Webseiten und anderen Ressourcen. Dieser 
Webserver wird dann so erweitert, dass anwendungsspezifi- 
sche Klassen zur Laufzeit nachgeladen werden können, um 
mit deren Hilfe Webseiten ad hoc zu generieren. 
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6 XML Remote Procedure Call (XML-RPC) 

In diesem Kapitel behandeln wir Remote Procedure Calls 
(RPC) und zeigen anhand des XMZ-iJPC’-Verfahrens, wie 
HTTP und XML als Datenaustauschformat für den entfernten 
Prozeduraufruf eingesetzt werden können. Auf dieser Basis 
implementieren wir einfache Web Services und zeigen, wie 
die XML-RPC-Verarbeitung in Apache Tomcat eingebunden 
werden kann. 

7 Entfernter Methodenaufruf mit RMI 

Remote Method Invocation (RMI) ist eine einfache und elegan- 
te Art, Client/Server-Anwendungen in Java zu implementie- 
ren. Der Entwickler kann sich ganz auf die fachliche Funktio- 
nalität konzentrieren, netzspezifische Details bleiben ihm im 
Gegensatz zur Socket-Programmierung weitestgehend ver- 
borgen. Entfernte Methoden werden prinzipiell wie lokale 
Methoden aufgerufen. Mit Hilfe der Objektserialisierung kann 
RMI beliebige Objekte als Aufrufparameter entfernter Metho- 
den übertragen. Dabei kann auch der zugehörige Bytecode, 
sofern er lokal nicht vorhanden ist, ad hoc transferiert wer- 
den. Damit sind dann sehr flexible Anwendungen möglich: 
mobile Agenten, Anwendungen mit automatischem Rückruf 
(Callback) bei Eintritt bestimmter Ereignisse. Das Kapitel 
schließt mit einem Exkurs, der zeigt, wie RMI mit Hilfe des 
CORBA-Protokolls IIOP CORBA-fähig gemacht werden kann. 

8 Nachrichtendienste mit JMS 

Ein wichtiger Standard für die asynchrone Verteilung von 
Nachrichten auf der Basis nachrichtenorientierter Middleware 
ist der Java Message Service (JMS). Bekannte Kommunikati- 
onsmodelle, um Nachrichten auszutauschen sind: das Point- 
to-Point-Modell und das Publish-Subscribe-Modell. In diesem 
Kapitel werden die wichtigsten Schnittstellen des JMS-API 
vorgestellt. 



Von den Leserinnen und Lesern werden erwartet: 

• Grundlegende Java-Kenntnisse, insbesondere: Konzepte der 
objektorientierten Programmierung, Dateiverarbeitung und 
Thread-Programmierung. 

• Grundlegende Kenntnisse auf dem Gebiet der relationalen 
Datenbanken und SQL. 

• Das Wissen um Internet und World Wide Web und cler Um- 
gang mit einem Webbrowser. 

• Grundlagenkenntnisse in HTML und XML. 



Eru>artungen an 
den Leser 
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1 Einleitung und Grundlagen 



Die Beispiele 



Werkzeug Ant 



Download 



Alle Beispielprogramme und Lösungen zu den Übungsaufgaben 
wurden mit Hilfe von Java SE 5.0 und Java SE 6.0 unter Windows 
2000 und Windows XP entwickelt und im Netz getestet. Selbst- 
verständlich sind die hier vorgestellten Programme ohne Ände- 
rung auch auf UNIX/Linux-Systemen lauffähig. 

Zur Vereinfachung der Programmentwicklung wurde das Build- 
Werkzeug Ant der Apache Software Foundation genutzt (siehe 
Quellenverzeichnis am Ende des Buches). Im Anhang befindet 
sich eine kurze Anleitung zur Installation und Nutzung von Ant 
für die Programme dieses Buches. 

Weitere Einzelheiten, z.B. zu den eingesetzten Datenbanksyste- 
men und JDBC-Treibern, können Kapitel 2 entnommen werden. 
Bezugsquellen können am Ende des Buches nachgeschlagen 
werden. 

Sämtliche Programme und Lösungen stehen im Internet zur Ver- 
fügung und können heruntergeladen werden. Hinweise zu wei- 
teren Tools und Klassenbibliotheken erfolgen in den Kapiteln, in 
denen sie erstmalig benutzt werden. Das Quellenverzeichnis am 
Ende des Buches enthält die Bezugsquellen. 

1.2 Verteilte Systeme 

Umfassende gesellschaftliche und wirtschaftliche Entwicklungen 
zwingen Unternehmen, sich flexibel an Veränderungen anzupas- 
sen und schnell auf neue Marktsituationen zu reagieren. Betrieb- 
lichen Anwendungssystemen kommt hier eine besondere Bedeu- 
tung zu. Wie sind die Anwendungssysteme zu implementieren, 
um höchstmögliche Flexibilität, Verlässlichkeit und Anpassbarkeit 
zu erreichen? 

Monolithische Systeme (alle Anwendungen laufen auf einem 
Rechner) sind nur noch bedingt geeignet. Heute ist die Struktu- 
rierung der Software in Client und Server weit verbreitet. 

Die folgenden Faktoren haben die fundamentalen Änderungen 
wesentlich beeinflusst: 

• Leistungsexplosion in der Mikroprozessortechnik, 

• schnelle Datennetze, 

• Fortschritte in der Softwaretechnik, 

• Abkehr von hierarchischen Organisationsstrukturen, 

• Bedürfnis nach Integration bisher nicht integrierter Systeme, 

• Internet-Technologie. 

Waren die 1960er Jahre noch durch Batch-Processing-Systeme, 
Lochstreifen und Lochkarten geprägt, konnten Anfang der 1970er 
Jahre in so genannten Timesharing-Systemen Transaktionen im 
Dialog gestartet werden. Minicomputer (UNIX- Systeme) erschie- 
nen als zweiter Gerätetyp neben dem Host. Anfang der 1980er 
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Jahre kamen die Personal Computer als Stand-alone-Systeme 
oder vernetzt im LAN hinzu. Der wichtigste Trend ab 1990 ist 
durch das Aufkommen von Client/Server-Systemen für die verteil- 
te Verarbeitung bestimmt. Hierzu zählen insbesondere die heuti- 
gen Internet- Anwendungen (Web-Informationssysteme, E-Busi- 
ness-An Wendungen) . 



Bild 1.1: 

Entwicklungsstufen 

Personal 

Computer 

Timesharing- 

Systeme 

Batch-Processing- 

Systeme 



I960 1970 1980 1990 2000 



Verteilte Systeme 
Client/Server-Systeme 



Jede Anwendung kann in drei wesentliche Schichten eingeteilt 
werden: 

1 . Präsentation 

Diese Schicht (auch Benutzungsschnittstelle genannt) hat die 
Aufgabe, den Dialog mit dem Benutzer zu steuern sowie Da- 
ten und Befehle an das System zu übermitteln. 

2. Verarbeitung 

Diese Schicht stellt die Verarbeitungslogik dar. Hier wird der 
eigentliche Nutzen der Anwendung erzielt. 

3. Datenhaltung 

Diese Schicht hat die Aufgabe, die Daten abzuspeichern und 
bei Bedarf wieder zur Verfügung zu stellen. 

Bild 1.2 zeigt eine Webanwendung, die dem Benutzer das Pro- 
duktangebot eines Unternehmens präsentiert. Die drei Schichten 
Präsentation, Verarbeitung und Datenhaltung sind jeweils auf 
eigenen Rechnern implementiert. Der Webbrowser ist die Benut- 
zungsoberfläche, die die abgefragten Informationen grafisch prä- 
sentiert. Der Webserver erzeugt Datenbankabfragen, bereitet die 
Abfrageergebnisse als Webseite auf und übermittelt diese an den 
Client. Der Datenbankserver verwaltet den Produktkatalog und 
führt die Datenbankabfragen aus. Webbrowser, Webserver und 
Datenbankserver sind autonome Teilsysteme, die koordiniert 
miteinander kooperieren. 
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Bild 1 2 : 

Beispiel einer 
Webanwendung 



Verteiltes System 



Konfigurations- 

problem 



Bild 13: 

Abbildung der 
logischen auf die 
physische Struktur 



Lokales Netz einer Firma 




Verteilung bedeutet die Zuordnung von Funktionen und Daten 
auf mehrere Rechner. Ein Anwendungssystem wird dabei in 
funktionale Komponenten zerlegt, die dann bei der Installation 
im Netz so verteilt werden, dass die Komponenten optimal un- 
terstützt werden. 

Abstrakt formuliert ist ein verteiltes System eine Menge von Kom- 
ponenten, die kooperieren, um eine gemeinsame Aufgabe zu 
erfüllen. 

Da es im Allgemeinen mehrere Varianten für die Installation der 
Komponenten im Netz gibt, besteht das Konfigurationsproblem , 
die logische Struktur der Anwendung auf die physische Struktur 
(Rechner im Netz) so abzubilden, dass bei vorgegebenen Rand- 
bedingungen ein maximaler Nutzen erzielt wird. 

Ob eine Verteilung überhaupt möglich ist, entscheidet sich beim 
Design der Anwendungssoftware. Das Design muss unabhängig 
von einer späteren physischen Konfiguration sein. Dem Benutzer 
muss die konkrete physische Aufteilung verborgen bleiben. 



logische Struktur 



physische Struktur 




Sachbearbeiter Sachbearbeiter 




Kundendaten Auftragsbearbeitung 
Produktdaten 



Der Vergleich der verteilten Verarbeitung mit der großrechner- 
dominierten, zentralen Verarbeitung ergibt folgende Vor- und 
Nachteile: 
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• Besseres Abbild der Realität 

Die Verteilung unterstützt die "schlanke" Organisation. Leis- 
tungen werden dort erbracht, wo sie benötigt werden. Daten 
werden dort erfasst, wo sie im Geschäftsprozess entstehen. 

• Wirtschaftlichkeit 

Teure Ressourcen (Geräte, Softwarekomponenten) stehen 
mehreren Rechnern zur Verfügung und können gemeinsam 
genutzt werden. Automatisierte Aufgaben werden möglichst 
dort ausgeführt, wo sie am wirtschaftlichsten sind. 

• Bessere Lastverteilung 

Da mehrere Rechner mit jeweils eigenem Betriebssystem ar- 
beiten, kann durch teilweise parallele Verarbeitung die Ge- 
samtbearbeitungszeit verkürzt werden. 

• Bessere Skalierbarkeit 

Einzelne Komponenten können leichter an einen steigenden 
Bedarf angepasst werden. 

• Fehlertoleranz 

Beim Ausfall eines Rechners bleiben die anderen betriebsbe- 
reit. Die Aufgaben des ausgefallenen Rechners können oft 
von einem anderen Rechner übernommen werden. 

• Höhere Komplexität durch Verteilung und Heterogenität 

Die Verteilung der Komponenten großer Systeme und die He- 
terogenität bei Betriebssystemen, Programmiersprachen, Da- 
tenformaten und Kommunikationsprotokollen stellen hohe 
Anforderungen an die Entwickler, wenn das Gesamtsystem 
überschaubar bleiben soll. 

• Komplexe Netzinfrastrukturen 

Netzarchitektur und Netzmanagement sind das Rückgrat der 
Systeme eines Unternehmens. Die Integration heterogener 
Systeme mit Komponenten unterschiedlicher Hersteller- und 
Standardarchitekturen stellt hohe Anforderungen an die Ad- 
ministration. 

• Höhere Sicherheitsrisiken 

Verteilte Systeme bieten mehr Möglichkeiten für unberechtig- 
te Zugriffe. Im Netz übertragene Nachrichten können abge- 
hört oder sogar verändert werden. Der Einsatz von Verschlüs- 
selungsverfahren und Firewall-Systemen sind wirksame 
Schutzmaßnahmen. 

Aufgabe von so genannten Verteilungsplattformen ist es, diese 
Komplexität beherrschbar zu machen. 



Vorteile 



Nachteile 
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Eine Software- 
architektur 



Hardware-Sicht 



1.3 Das Client/Server-Modell 

Das Client/Server-Modell ist das am weitesten verbreitete Modell 
für die verteilte Verarbeitung. 

Client/Server bezeichnet die Beziehung, in der zwei Programme 
zueinander stehen. Der Client stellt eine Anfrage an den Server, 
eine gegebene Aufgabe zu erledigen. Der Server erledigt die 
Aufgabe und liefert das Ergebnis beim Client ab. Ein Kommuni- 
kationsdienst verbindet Client und Server miteinander. 

Ein Client/Server-System besteht also aus 

• einem oder mehreren Clients (Auftraggebern), 

• einem Server (Auftragnehmer) und 

• einem Kommunikationsdienst (Netzwerk, Vermittler). 

Client und Server sind Programme, die auch auf demselben 
Rechner laufen können. Sie müssen also nicht notwendig 
über ein Netz verbunden sein. Das macht deutlich, dass es sich 
hierbei um eine Software- und keine Hardwarearchitektur han- 
delt. In der Praxis werden natürlich Client und Server auf unter- 
schiedlichen Rechnern verteilt, um die bekannten Vorteile eines 
verteilten Systems zu erzielen. 

Gelegentlich werden auch die Trägersysteme (Rechner), auf de- 
nen die Programme laufen, als Client bzw. Server bezeichnet. 
Wir nutzen die Begriffe Client bzw. Server als Homonyme. Aus 
dem Zusammenhang wird dann klar, welche Bedeutung gemeint 
ist. 

Ein Server kann die Erledigung einer Aufgabe weiter delegieren 
und dazu auf andere Server zugreifen. Er spielt dann selbst die 
Rolle eines Client. Der Webserver in Bild 1.2 hat diese Doppel- 
funktion. 



Bild 1.4: 

CI ient/Server-Modell 




Im Folgenden sind charakteristische Merkmale von Client und 
Server zusammengefasst: 
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• Ein Programm wird vorübergehend zum Client, wenn es ei- 
nen Dienst von einem anderen Programm (Server) anfordert. 
Darüber hinaus kann das Programm andere Aufgaben lokal 
ausführen. 

• Der Client läuft in der Regel auf dem Rechner eines Benutzers 
und leitet den Kontakt mit einem Server aktiv ein. 

• Der Client kann im Laufe einer Sitzung auf mehrere Server 
zugreifen, kontaktiert aber aktiv nur jeweils einen Server. 

• Der Server ist ein Programm, das einen bestimmten Dienst 
bereitstellt. Er kann in der Regel gleichzeitig mehrere Clients 
bedienen. 

• Häufig werden Server automatisch beim Hochfahren des 
Rechners gestartet und beim Herunterfahren beendet. 

• Der Server wartet passiv auf die Verbindungsaufnahme durch 
einen Client. 

• Da Server eigenständige Programme sind, können mehrere 
Server unabhängig voneinander auf einem einzigen Rechner 
als Trägersystem laufen. 

• Parallelbetrieb ist ein grundlegendes Merkmal von Servern. 
Mehrere Clients können einen bestimmten Dienst in An- 
spruch nehmen, ohne warten zu müssen, bis der Server mit 
der Erledigung der laufenden Anfrage fertig ist. In den späte- 
ren Java-Programmbeispielen werden die Client-Anfragen je- 
weils in einem neuen Thread bedient. 
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Bild 1.5: 

Interaktionsarten 
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synchron/asynchron 



Multi-Tier- 

Architekturen 



Bild 1.6: 

Eine zweistufige 
Architektur 



Die Interaktion zwischen Client und Server kann synchron oder 
asynchron erfolgen (siehe Bild 1.5). 

Bei der synchronen Kommunikation wartet der Client nach Ab- 
senden der Anfrage an den Server so lange, bis er eine Rückant- 
wort erhält, und kann dann erst andere Aktivitäten ausführen. 

Im asynchronen Fall sendet der Client die Anfrage an den Server 
und arbeitet sofort weiter. Beim Eintreffen der Rückantwort wer- 
den dann bestimmte Ereignisbehandlungsroutinen beim Client 
aufgerufen. Die durch den Server initiierten Rückrufe ( Callhacks ) 
erfordern allerdings zusätzliche Kontrolle beim Client, wenn 
ungewünschte Unterbrechungen der Arbeit vermieden werden 
sollen. 



1.4 Mehrstufige Architekturen 

Bei einstufigen Architekturen wird die gesamte Anwendung 
(Präsentation, Verarbeitung und Datenhaltung) auf einem Rech- 
ner implementiert. Die Benutzerinteraktion erfolgt über Termi- 
nals, die direkt oder über einen Terminal- bzw. Kommunikati- 
onsserver an den Rechner angeschlossen sind. 

Verteilte Anwendungen haben eine mehrstufige Architektur 
{Multi-Tier- Architektur). Beispielsweise werden Applikations- 
und Datenbankserver verschiedenen Ebenen zugeordnet. 

Bei der zweistufigen Architektur ist die Gesamtanwendung zwei 
Ebenen zugeordnet: Client und Server. 




Für die Arbeitsteilung zwischen Client und Server existieren ver- 
schiedene Alternativen, je nachdem, wo die Schichten Präsenta- 
tion, Verarbeitung und Datenhaltung angesiedelt sind. 

Bild 1.7 zeigt fünf Alternativen der Aufgabenverteilung bei der 
zweistufigen Architektur eines Client/Server-Systems. Von Alter- 
native 1 bis 5 wird immer mehr Funktionalität auf den Client 
übertragen. 
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Alternative 1 zeigt den Fall einer Webanwenclung, bei der HTML- 
Seiten vom Server generiert und vom Webbrowser angezeigt 
werden. 

Ein Beispiel zur Alternative 2 ist eine Webanwendung, bei der 
eingegebene Daten über ein Applet im Webbrowser an den 
Server zur Verarbeitung weitergeleitet werden. 

Bei den Alternativen 3 und 5 hat der Client einen Teil der Verar- 
beitung bzw. Datenhaltung selbst übernommen. 

Alternative 4 zeigt den Fall eines typischen Datenbankservers. 




1 2 3 4 5 



Bild 1.7: 

Alternativen der 
A iifga benverteilu ng 



Bei der dreistufigen Architektur wird die Gesamtanwendung auf 
drei Ebenen aufgeteilt: z.B. Client, Applikationsserver und Da- 
tenbankserver. Dieses Modell ist auch Basis vieler ERP-Systeme 
(Enterprise Resource Planning). 




Bild 1.8: 

Eine dreistufige 
Architektur 



Insbesondere bei Internet- und Intranet-Anwendungen findet 
man eine vierstufige Architektur, bei der ein Webserver dem 
Applikationsserver vorgeschaltet ist. 
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Bild 1.9: 

Eine vierstufige 
Architektur 



Bild 1.10: 

Middleware 




1.5 Middleware und Transparenz 

In mehrstufigen Architekturen sind die Komponenten eines An- 
wendungssystems auf potentiell heterogene Trägersysteme in 
einem Netzwerk verteilt. Um die Komplexität des Gesamtsystems 
bei der Bedienung oder Entwicklung der Anwendung vor dem 
Benutzer bzw. Entwickler verborgen zu halten, bedarf es einer 
geeigneten Software-Infrastruktur, die die Interaktion zwischen 
den Komponenten in besonderer Weise unterstützt. 

Die verteilte Verarbeitung hat zu einem neuen Typ systemnaher 
Software geführt, der so genannten Middleware. 

Middleware ist Kommunikationssoftware, die den Austausch von 
Informationen zwischen den verschiedenen Komponenten eines 
verteilten, heterogenen Systems unterstützt. Die Anwendungen 
werden dabei von den komplexen Details der internen Vorgänge 
abgeschirmt. 



Anwendungskomponenten 



Middleware 



Betriebssysteme, Protokolle, Netzwerk 
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In der Informatik nennt man eine Sache transparent, wenn sie 
"durchsichtig", also nicht sichtbar ist. 

In verteilten Systemen sollen interne Abläufe und Implementie- Verteilung 
rungsdetails für den Benutzer oder Anwendungsentwickler nicht verbergen 
sichtbar sein. Verteilungstransparenz verbirgt die Komplexität 
verteilter Systeme. 

Es existieren mehrere untergeordnete Transparenzbegriffe, die 
jeweils einen bestimmten Aspekt bezeichnen. Beispiele hierfür 
sind: 

• Ortstransparenz 

Der Ort einer Ressource ist dem Benutzer nicht bekannt. Er 
identifiziert sie über einen Namen, der keine Information ü- 
ber ihren Aufenthaltsort enthält. 

• Zugriffstransparenz 

Die Form des Zugriffs auf eine Ressource ist einheitlich und 
unabhängig davon, ob die Ressource lokal oder auf einem 
entfernten Rechner zur Verfügung steht. Unterschiede ver- 
schiedener Betriebssysteme und Dateisysteme werden ver- 
borgen. 

• Nebenlä ufigkeitstra nspa renz 

Der gleichzeitige Zugriff mehrerer Benutzer auf dieselbe Res- 
source (z.B. Datenbanktabelle) erfolgt ohne gegenseitige Be- 
einflussung und lässt keine falschen Ergebnisse entstehen. 

• Replikationstransparenz 

Sind aus Verfügbarkeits- oder Performance-Gründen mehrere 
Kopien einer Ressource (z.B. eines Datenbestandes) vorhan- 
den, so merkt der Benutzer nicht, ob er auf das Original oder 
eine Kopie zugreift. Das System sorgt dafür, dass alle Kopien 
bei Änderungen konsistent bleiben. 

• Migrationstransparenz 

Ressourcen können von einem Rechner auf einen anderen 
verlagert werden, ohne dass der Benutzer dies bemerkt. 

• Fehlertransparenz 

Der Benutzer soll nicht mit allen auftretenden Fehlern im Sys- 
tem konfrontiert werden. Das Auftreten von Fehlern und die 
Fehlerbehebung sollen vor dem Benutzer weitestgehend ver- 
borgen sein. 



Middleware-Proclukte stellen dem Entwickler die für die Anwen- 
dung benötigten Funktionen meist in Form eines API 
(Application Programming Interface) zur Verfügung. 

Datenbank-Middleware ermöglicht den Zugriff auf unterschiedli- Datenbank- 
che Datenbanksysteme, ohne das Anwendungsprogramm beim Middleware 
Wechsel des Datenbanksystems ändern zu müssen. Das JDBC- 
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Bild 1.11: 

Entfernter 

Prozeduraufruf 



RPC 



API erlaubt es einem Java-Programm, SQL-Anweisungen an be- 
liebige SQL-Datenbanken zu schicken (siehe Kapitel 2). 

Andere Middleware-Produkte verwenden eine synchrone Ver- 
bindung zwischen Client und Server, um Prozeduren nach dem 
RPC-Modell aufzurufen. 



Client Server 




Der Remote Procedure Call ( RPC) versteckt den Aufruf einer auf 
einem anderen Rechner im Netz implementierten Prozedur hinter 
einem lokalen Prozeduraufruf und bietet damit ein sehr vertrau- 
tes Programmiermodell an. Das Programm, das die Prozedur 
aufruft, agiert als Client, das Programm, das die aufgerufene 
Prozedur ausführt, als Server. 

RMI ( Remote Method Invocation ) ist die objektorientierte Umset- 
zung des RPC-Modells für Java-Programme (siehe Kapitel 7). 



Die folgenden Programmbeispiele zeigen, wie einfach eine An- 
wendung mit lokalem Methodenaufruf in eine Client/Server- 
Anwendung mit entferntem Methodenaufruf (RMI ) umgewandelt 
werden kann. 

Die im Beispiel benutze Methode berechnet die Summe zweier 
Zahlen. 

Zunächst die lokale Anwendung: 
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public dass AddServer { 

public double add (double x, double y) { 
retum x + y; 



} 



public dass AddClient { 

public static void main( String [] args) { 
AddServer Service = new AddServer ( ) ; 
System, out .printin (Service. add (2. 3, 5.7) ) ; 



} 



Die beiden Klassen werden nun mittels eines Interface ent- 
koppelt. Um ein Server-Objekt zu erzeugen, wird eine statische 
Methode benutzt, die den konkreten Namen der Implementie- 
rungsklasse (hier: AddServer) gegenüber dem Client verbirgt 
C Factory-Methode ). 



public interface Add { 

double add (double x, double y ) ; 

} 



public dass AddServer implements Add { 
public double add (double x, double y) { 
retum x + y; 

} 

) 



public dass AddFactory { 
public static Add getAddO { 
retum new AddServer ( ) ; 




public dass AddClient { 

public static void main( String [] args) { 

Add Service = AddFactory.getAddO; 

System. out. printin (Service. add (2. 3, 5.7) ) ; 




Das Klassendiagramm in Bild 1.12 verdeutlicht die Zusammen- 
hänge. 



Programm 1.1 



Programm 1 2 
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Bild 1.12: 

Klassendiagra m m 
zu Programm 1.2 



Programm 1.3 




Die RMI-Version der Anwendung entsteht nun durch leichte 
Änderung von Programm 1.2. 



import java.mi.*; 

public interface Add extends Remote { 

double add (double x, double y) throws RemoteException; 

} 



irrport java.mi.*; 
irrport java.rmi. Server.*; 

public dass AddServer extends UnicastRemoteObject implements Add { 
public AddServer () throws RemoteException { } 

public double add (double x, double y) throws RemoteException { 
retum x + y; 

} 



public static void main (String [ ] args) throws Exception { 
AddServer Server = new AddServer ( ) ; 

Naming . rebind ( " add" , Server) ; 
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import java.rmi.*; 

public dass AddFactory { 

public static Add getAddO throws Exception { 
retum (Add) Naming.lookup("//localhost/add") ; 

} 

> 



public dass AddClient { 

public static void main (String [] args) throws Exception { 
Add Service = AddFactory.getAddO ; 

System. out. println(service.add(2. 3, 5.7) ) ; 




Add, Addserver und AddFactory importieren RMI-Pakete. 

Das Interface Add ist von java.rmi. Remote abgeleitet, die Methode 
add enthält eine throws-Klausel mit der Ausnahme java.rmi. Remote- 
Exception. 

Die Klasse AddServer ist von java.rmi. Server. UnicastRemoteObject 
abgeleitet und besitzt eine main-Methode, die das erzeugte Server- 
Objekt bei einem Verzeichnisdienst registriert. 

Die Methode getAdd der Klasse AddFactory erhält ihr Add-Objekt mit 
Hilfe dieses Verzeichnisdienstes. 



Zur Vereinfachung sollen Client und Server auf demselben Rech- 
ner laufen. 

Zunächst müssen die Sourcen compiliert werden: 

mkdir build 

javac -sourcepath src -d build src/* . java 

Start des Verzeichnisdienstes: 

Start /Dbuild miregistry 



Start des Servers: 

Start java -cp build Addserver 



Aufruf des Client: 



java -cp build AddClient 
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Internet 



Bild 1.13 

Grundstruktur 
des Internets 



TCP/IP 



Intranet 



1 .6 Grundbegriffe des Internets 

Das Internet ist ein weltumspannendes Rechnemetz, das aus 
einer Vielzahl von internationalen und nationalen öffentlichen 
Netzen sowie privaten lokalen Netzen besteht. Spezielle Kopp- 
lungselemente, so genannte Router, verbinden diese Teilnetze 
miteinander und ermöglichen so den Datenaustausch zwischen 
Rechnern, die sich in unterschiedlichen Teilnetzen befinden. Das 
Internet ist ein offenes Netz, zu dem Unternehmen, nicht- 
kommerzielle Organisationen sowie Privatpersonen gleicherma- 
ßen Zugang haben. 

Kommunikationsprotokolle beinhalten Sprach- und Handlungsre- 
geln für den Datenaustausch. Sie sind das Verständigungsmittel 
in einem Rechnernetz. 




TCP/IP (Transmission Control Protocol/Internet Protocol) be- 
zeichnet eine Familie von einzelnen, aufeinander abgestimmten 
Protokollen für die Kommunikation im Internet. TCP und IP sind 
die beiden wichtigsten Protokolle dieser Familie. 

Im Gegensatz zum offenen Internet ist ein Intranet ein privates, 
innerbetriebliches Rechnernetz auf Basis der Internet-Protokolle 
("privates Internet"). 



Zur Beschreibung der Kommunikation werden allgemein Schich- 
tenmodelle eingesetzt. Im Internet werden vier aufeinander 
aufbauende Schichten unterschieden. Jede Schicht hat ihre 
eigene Funktionalität, die sie der jeweils höheren Schicht zur 
Verfügung stellt. 
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4 Anwendungsschicht 

3 Transportschicht 

2 Vermittlungsschicht 

1 Verbindungsschicht 



Bild 1.14: 

TCP/IP- 

Schichtenmodell 



1. Die Verbindungsschicht umfasst die Netzwerkhardware und 
Gerätetreiber. Sie ist die Basis für eine zuverlässige physische 
Verbindung zwischen zwei benachbarten Systemen. 

2. Die Vermittlungsschicht enthält das Protokoll IP (Internet 
Protocol), das die Internet-Adressen (IP-Adressen) definiert, 
die als Basis für die Wegwahl im Internet dienen. Einzelne 
Datenpakete werden vom Sender zum Empfänger über ver- 
schiedene Teilnetze des Internets geleitet. Das hier angesie- 
delte Protokoll ARP (Address Resolution Protocol) übersetzt 
logische IP-Adressen in physische Adressen (Hardwareadres- 
sen) einer Datenstation im lokalen Netz. 

3. Die Transportschicht enthält die beiden Protokolle TCP 
(Transmission Control Protocol) und UDP (User Datagram 
Protocol). 

TCP stellt der Anwendung ein verlässliches, verbindungs- 
orientiertes Protokoll zur Verfügung. Vor der eigentlichen Da- 
tenübertragung in Form von Datenpaketen wird eine virtuelle 
Ende-zu-Ende-Verbindung zwischen Sender und Empfänger 
aufgebaut. 

UDP ist ein so genanntes verbindungsloses Protokoll. Daten- 
pakete werden ins Internet geschickt, ohne dass vorher eine 
Verbindung mit dem Empfänger hergestellt wurde. 

UDP und TCP werden in den Kapiteln 3 und 4 ausführlich 
behandelt. 

4. Beispiele für die Protokolle der Anwendungsschicht sind: 
SMTP (Simple Mail Transfer Protocol), Telnet, FTP (File Trans- 
fer Protocol) und HTTP (Hypertext Transfer Protocol), das die 
Basis für das World Wide Web (WWW) ist. 
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Bild 1.15: 

Datenübertragung 
mittels TCP 



IP-Adressen 



Bild 1.15 zeigt den Ablauf einer Kommunikation zwischen Client 
und Server, die ihre Daten direkt über TCP austauschen. 




Der Client übergibt seine Daten an die Transportschicht. TCP 
sorgt für die Aufteilung der Daten in Pakete, versieht jeweils die 
Nutzdaten eines Pakets mit einem Datenkopf (Header) und gibt 
die Pakete weiter an die Vermittlungsschicht. Die Vermittlungs- 
schicht fügt ihrerseits einen IP-Header hinzu. Schließlich packt 
die Netzwerkkarte einen Rahmen um die Daten. Beim Empfän- 
ger werden in umgekehrter Reihenfolge die Header Schicht für 
Schicht wieder entfernt und ausgewertet, bevor die Daten an die 
übergeordnete Schicht weitergegeben werden. 



Eine Aufgabe des Protokolls IP ist die Bereitstellung eines Adres- 
sierungsschemas, das von den physischen Adressen der Netz- 
werkhardware unabhängig ist. 

Jeder Rechner im Internet (genauer: der Rechner als Komponen- 
te eines Teilnetzes) hat eine eindeutige IP-Adresse, die in der zur 
Zeit noch vorherrschenden Version IPv4 aus 32 Bit besteht und 
durch eine Folge von vier durch Punkte getrennte Zahlen zwi- 
schen 0 und 255 dargestellt wird. 

Eine IP-Adresse besteht aus zwei Teilen: der Netzadresse , die das 
Netz eindeutig identifiziert, und der Rechneradresse, die den 
Rechner in diesem Netz eindeutig identifiziert. Offizielle Netzad- 
ressen werden zentral vergeben, Rechneradressen können frei 
vom Netzwerkadministrator der jeweiligen Institution vergeben 
werden. 

Drei Adressklassen werden unterschieden: A, B und C. Adressen 
der Klasse A nutzen 8 Bit für die Netzadresse (beginnend mit 0), 
Adressen der Klasse B 16 Bit (beginnend mit 10) und Adressen 
der Klasse C 24 Bit (beginnend mit 110). 
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Beispiel: 

Die IP-Adresse 194.94. 124. 236 gehört zur Klasse C und identifiziert 
einen Rechner in dem durch die Netzadresse 194 . 94 . 124.0 identifi- 
zierten Netz. 

Jeder Rechner im Internet kann sich selbst mit der Adresse 

127 . 0 . 0.1 adressieren. 

Private IP-Adressen wie z.B. 10.0.0.0 bis 10.255.255.25s oder 

192.168.0. 0 bis 192.168.255.255 werden nie im Internet geroutet. 
Jede Organisation kann sie frei im internen Netz verwenden. 

Die starre Klasseneinteilung der IP-Adressen wird durch das 
heute übliche Verfahren CIDR (Classless Inter Domain Routing) 
aufgehoben. Hierbei erfolgt die Aufteilung in Netz- und Rech- 
neradresse bitweise mit Hilfe von Subnetzmasken. 



Zur besseren Handhabbarkeit wird das Nummernsystem durch 
ein Namensystem, dem Domain Name System (DNS), überlagert. 
IP-Adressen werden einem sprechenden Namen, dem Domain- 
Namen, zugeordnet. Domain-Namen sind hierarchisch aufgebaut. 

Beispiel: www.hs-niederrhein.de 

Hier handelt es sich um den Webserver der Hochschule Nieder- 
rhein mit de (Deutschland) als Top Level Domain. 

Der Hostname locaihost identifiziert den eigenen Rechner und 
entspricht der IP-Adresse 127 . 0 . 0 . 1 . 

DNS-Server sind spezielle Verzeichnisdienste, die die Zuordnung 
von IP-Adressen zu DNS-Namen und umgekehrt unterstützen. 
Hierüber kann z.B. die IP-Adresse zu einem Namen erfragt wer- 
den. 

Zu beachten ist, dass mehrere Rechner mit jeweils eigener IP- 
Aclresse denselben DNS-Namen haben können und zu einer IP- 
Aclresse mehrere DNS-Namen gehören können. 



Um einen bestimmten Dienst (Server) im Internet zu identifizie- 
ren, reicht die IP-Adresse des Rechners, auf dem der Server läuft, 
nicht aus, da mehrere Server auf demselben Rechner gleichzeitig 
laufen können. 

Zur Identifizierung eines Servers dient neben der IP-Adresse des 
Rechners die so genannte Portnnmmer. Portnummern werden 
auch vom Server benutzt, um den anfragenden Client für die 
Rückantwort zu adressieren. Portnummern sind ganze Zahlen 
von 0 bis 65535. Sie werden von den Protokollen der Transport- 
schicht verwendet. TCP und UDP können Portnummern unab- 
hängig voneinander verwenden, d.h. ein TCP-Server und ein 
UDP-Server können auf einem Rechner unter derselben Port- 



DNS 



Portnummer 
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nummer zur gleichen Zeit laufen. Die Portnummern von 0 bis 
1023 sind weltweit eindeutig definiert und für so genannte well- 
known Services reserviert. 



Bild 1.16: 

Beispiel für well- 
known Services 


Port 


Protokoll 


Service 


Beschreibung 


7 


TCP/IP 


echo 


liefert die Eingabe als Antwort 
zurück 
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TCP/UDP 


daytime 


liefert die aktuelle Zeit des Servers 




20 


TCP 


ftp-data 


überträgt Daten zum Server 
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sendet FTP-Kommandos zum 
Server 
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Rechnern 
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Die Liste der well-known Portnummern kann über 

http : //www . iana . org/ assignments/port-numbers 

abgefragt werden. 

Im Bereich von 1024 bis 49151 sind weitere Portnummern regist- 
riert, z.B. 1099 für die RMI-Registry und 3306 für den MySQL- 
Datenbankserver. 



1.7 Die Klasse InetAddress 

Die Klasse java.net. InetAddress repräsentiert eine IP-Adresse. Sub- 
klassen hiervon sind Inet4Address und Inet6Address, die IP- 
Adressen der Version 4 bzw. 6 speichern können. 

Die folgenden drei statischen Methoden erzeugen inetAddress- 
Objekte: 

static InetAddress getLocalHost ( ) throws UnknownHost Except ion 

ermittelt die IP-Adresse des Rechners, auf dem diese Methode 
läuft. 

Die Klasse java.net.UnknoraiHostException ist Subklasse von java.io. 
iOException. Eine Ausnahme dieses Typs wird ausgelöst, wenn die 
IP-Adresse eines Rechners nicht ermittelt werden kann. 

static InetAddress getByName (String host) throws UnknownHostException 



1.7 Die Klasse InetAddress 



23 



liefert die IP-Adresse zu einem Hostnamen. Enthält das Argument 
host eine IP-Adresse in Punkt-Notation anstelle eines Namens, so 
wird nur die Gültigkeit des Adressformats geprüft. 

static InetAddress [ ] getAllByNama (String host) 
throws UnknownHostException 

liefert ein Array von IP-Adressen, die alle zum vorgegebenen 
Hostnamen gehören. Ergebnisse früherer Adressauflösungen 
innerhalb eines Programmlaufs werden zwischengespeichert und 
wiederverwendet. 

String getHostAddress ( ) 

liefert die IP-Aclresse eines inetAddress-Objekts in Punkt-Notation. 

String getHostName ( ) 

liefert den Hostnamen der IP-Adresse. Falls das inetAddress- 
Objekt mittels einer IP-Adresse in Punkt-Notation erzeugt wurde 
und der zugehörige Hostname nicht ermittelt werden konnte, 
wird die IP-Adresse in Punkt-Notation zurückgegeben. 



Programm 1.4 zeigt die IP-Adresse und den Hostnamen des ei- 
genen Rechners an. 



import java.net.*; 
public dass LocalHost { 

public static void main( String [] args) throws UnknownHostException { 
InetAddress addr = InetAddress.getLocalHostO; 
System.out.println("IP-Nummer:\t" + addr .getHostAddress ()) ; 

System. out. println("Hostname:\t" + addr . getHostName ()) ; 




Programm 1.5 liefert die IP-Adresse zu einem Hostnamen. 



import java.net.*; 
public dass Lookup { 

public static void main (String [] args) throws UnknownHostException { 
if (args.length != 1) { 

System. err .printin ("java Lookup (<hostname> | <ip-adresse>) ") ; 
System. exit(l) ; 

} 



InetAddress addr = InetAddress. getByName (args [0] ) ; 

System. out. println("IP-Nummer:\t" + addr .getHostAddress ()) ; 
System. out .printin ( "Hostname :\t" + addr . getHostName ()) ; 



Programm 1.4 



Programm 1.5 
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1 Einleitung und Grundlagen 



Test Wird im lokalen Netz kein Domain Name Server (DSN) genutzt, 

so können unter Windows 2000 und Windows XP in der Datei 
hosts im Verzeichnis <Systemroot>\system32\drivers\etc die Zu- 
ordnungen von IP-Adressen zu frei wählbaren Hostnamen fest- 
gelegt werden. 

java -cp build Lookup pc0823 
IP-Nunmer: 10.108.105.95 
Hostname: pc0823 

Wird beim Aufruf des Programms eine IP-Adresse in Punkt- 
Notation anstelle eines Namens mitgegeben und konnte der 
Hostname nicht ermittelt werden, so wird als Hostname die vor- 
gegebene IP-Adresse ausgegeben. 



1.8 Aufgaben 

1. Entwickeln Sie eine verbesserte Version von Programm 1.5 
mit den folgenden Eigenschaften: 

• Sind einem Hostnamen mehrere IP-Adressen zugeordnet, 
so sollen alle angezeigt werden. 

• Wird statt eines Namens eine IP-Adresse beim Aufruf 
mitgegeben, so soll eine Fehlermeldung ausgegeben 
werden, wenn der Hostname nicht ermittelt werden 
konnte, ansonsten soll der zugeordnete Hostname ange- 
zeigt werden. 

Beispiel: 

java -cp build Lookup www.microsoft.com 
Hostname : www . microsof t . com 

IP-Nummer: 207.46.244.188 
Hostname : www . microsof t . com 

IP-Nummer: 207.46.245.92 

2. Schreiben Sie ein Programm showip, das die IP-Adresse und 
den Hostnamen des lokalen Rechners in einem Fenster an- 
zeigt. 

Bild 1.17: 

IP-Adresse und 

Hostname 



# IP-Adresse und Hostname 



10. 108. 105. 96 
pc0806 



1.8 Aufgaben 
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Dieses Programm kann z.B. genutzt werden, um die vom 
Provider dynamisch zugewiesene IP-Adresse bei einer Tele- 
fonverbindung anzuzeigen. 

Um showip mit einem Doppelklick auf einem grafischen 
Symbol starten zu können, muss nach der Compilierung ei- 
ne JAR-Datei erzeugt werden: 

jar cfin build/ showip. jar manifest.txt -C build ShowIP. dass 

Die Datei manifest.txt hat den Inhalt: 

Main-Class : ShowIP 

Diese Textzeile muss mit einem Zeilenvorschub abgeschlos- 
sen sein. 

Eine Verknüpfung mit showip.jar kann z.B. auf den Desk- 
top gelegt werden. 




2 Datenbankanwendungen mit JDBC 



JDBC (Java Database Connectivity) ist die Standard-Schnittstelle 
für den Zugriff auf relationale Datenbanken mittels SQL. Der 
Kern von JDBC besteht aus einer Sammlung von Klassen und 
Interfaces, die im Paket java.sqi zusammengefasst sind. Damit 
können Datenbankverbindungen aufgebaut, beliebige SQL- 
Anweisungen an die Datenbank geschickt und Abfrageergebnis- 
se im Programm verarbeitet werden. 

Java-Programme, die mittels JDBC auf eine Datenbank zugreifen, 
enthalten keinen datenbankspezifischen Code. Das ermöglicht 
den Austausch des Datenbanksystems (DBMS), ohne das Pro- 
gramm ändern zu müssen. JDBC stellt also eine datenbankneut- 
rale Zugriffsschnittstelle bereit. JDBC ist eine Abstraktionsschicht 
zwischen Java-Programm und SQL. 




Bild 2.1 

Sch ichten modelt 
einer Datenbank- 
anwendung 



Die zur Zeit der Drucklegung dieses Buches aktuelle Version 
JDBC 4.0 ist Teil von Java SE 6.0. In diesem Kapitel beschäftigen 
wir uns mit den Grundlagen von JDBC. 



2.1 Die Architektur von JDBC-Anwendungen 

Im einfachsten Fall wird JDBC im Client-Programm verwendet, 
das lokal oder über ein Netzwerk auf eine Datenbank zugreift 
(. zweistufige A rch itektu r) . 

Eine dreistufige Architektur trennt in der Regel die Anwen- 
dungslogik von der Benutzungsoberfläche und der Datenver- 
waltung. Ein Client (z.B. Webbrowser) kommuniziert über ein 
geeignetes Protokoll (z.B. HTTP) mit dem Applikationsserver, 
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Bild 22: 

2- und 3-stufige 
Architekturen 



T rei berko nzept 



Bild 23: 

JDBC-Treiber 



der seinerseits auf den Datenbankserver zugreift. Bild 2.2 zeigt, 
wie verteilte Systeme mit JDBC realisiert werden können. 



Client Client 




Jedes Datenbanksystem hat eine eigene, herstellerspezifische 
Zugriffsschnittstelle. Ein so genannter JDBC-Treiber übersetzt die 
JDBC-Methodenaufrufe in Aufrufe dieser Schnittstelle. So wird 
für jedes DBMS ein eigener Treiber benötigt. JDBC-Treiber exis- 
tieren für die meisten relationalen DBMS. Beim JDBC-Treiber zu 
einem DBMS handelt es sich um eine Bibliothek von Klassen, 
die die von JDBC vorgegebenen Interfaces implementieren. 




2.1 Die Architektur von JDBC-Anwendungen 
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Zur Realisierung von JDBC-Treibern gibt es grundsätzlich vier 
Möglichkeiten, die im Bild 2.4 zusammengefasst sind. 



Bild 2.4: 

Typen von JDBC- 
Treibern 




JDBC-ODBC-Bridge und ODBC-Treiber Typl 

Treiber dieses Typs benutzen das ODBC-API (Open Database 
Connectivity) von Microsoft, um auf relationale Datenbanken 
zuzugreifen. Ein JDBC-ODBC-Brückentreiber wandelt alle JDBC- 
Aufrufe in ODBC-Aufrufe um. Somit lassen sich vorhandene 
ODBC-Treiber nutzen, um Datenbankanwendungen mit JDBC zu 
realisieren. Allerdings setzt das eine ODBC-Installation auf dem 
Client voraus. Die JDBC-ODBC-Bridge ist als Paket sun. jdbc.odbc 
Bestandteil von Java SE. 

Native-API-Treiber Typ2 

Ein solcher Treiber nutzt die DBMS-spezifische Programmier- 
schnittstelle. Für jeden Client müssen clientseitige Bibliotheken 
(Binärcode) geladen werden. 

JDBC-Net-Treiber Typ3 

Treiber dieses Typs sind vollständig in Java realisiert. Sie nutzen 
eine zusätzliche Komponente (Middleware), die das DBMS- 
unabhängige Protokoll in ein DBMS-spezifisches Protokoll über- 
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setzt. Diese Lösung ist sehr flexibel, da von einem Wechsel des 
DBMS nur die Middleware betroffen ist. 

Typ 4 Native-Protokoll-Treiber 

Diese vollständig in Java implementierten Treiber übersetzen 
JDBC-Aufrufe direkt in das DBMS-spezifische Protokoll. Sie wer- 
den meist von den DBMS-Herstellern selbst angeboten. 

Bild 2.5 gibt einen Überblick über die wichtigsten Klassen und 
Interfaces desJDBC-API. 




■£> : extends [> : implements 



Die Klasse DriverManager handhabt das Laden des JDBC-Treibers 
und bietet Methoden zum Aufbau einer Datenbankverbindung. 

Die wichtigsten Interfaces: 

• Connection repräsentiert eine Datenbankverbindung. 

• Statement wird verwendet, um SQL-Anweisungen über eine 
gegebene Datenbankverbindung auszuführen. 

• Resuitset bietet Methoden, um auf das Ergebnis einer SQL- 
Abfrage zuzugreifen. 



2.2 Erste Beispiele 
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Bild 2.5 zeigt auch die Klassen der JDBC-ODBC-Bridge, die die 
Interfaces implementieren. 



2.2 Erste Beispiele 
2.2.1 Die Beispiel-Datenbank 

Um verschiedene Aspekte von JDBC in den nächsten Ab- 
schnitten demonstrieren zu können, benutzen wir eine Daten- 
bank, die Bücher verschiedener Verlage verwaltet. Bild 2.6 zeigt 
die Beziehung zwischen den Entitätstypen Verlag und buch. 




Bild 2.6: 

Datenmodell 



Ein Verlag hat verschiedene Bücher veröffentlicht. Ein Buch ist in 
genau einem Verlag erschienen. 

In einer relationalen Datenbank werden die Entitätstypen als 
Tabellen aus Zeilen und Spalten implementiert. Die Spalten rep- 
räsentieren die verschiedenen Merkmale einer Entität, beim Buch 
also z.B. ISBN-Nummer, Autor, Titel usw. Jede Zeile enthält alle 
Angaben zu einer einzigen Entität. 



V i*bn 


aut« 


| ttel 


| aurgafc* 


s«tenz4hl| 


iafc 


v«riaajd| 


«eis 


3-15-001 308 9 


Dickens. Charles 


Schwere Zeiten 


Kartoniert 


430 


1989 


9 


7.6 


3-15-001562-6 


Dickens. Charles 


Große Erwartungen 


Kartoniert 


751 


1993 


9 


12.6 


>15-010606-0 


Dickens. Charles 


Der Weihnachtsabend 


Gebunden 


118 


2006 


9 


69 


3-257-20998-3 


Dickens. Charles 


Nikolos NickJeby 


Kartoniert 


728 


1997 


4 


14 9 


>257-21034-5 


Dickens. Charles 


David Copperfield 


Kartoniert 


802 


1982 


4 


149 


>257-21 166-X 


Dickens. Charles 


Bleokhaus 


Kartoniert 


847 


1984 


4 


14 9 


>257-21405-7 


Dickens. Charles 


Die Pickwickier 


Kartoniert 


650 


2002 


4 


12.9 


>257-21406-5 


Dickens. Charles 


Martin Chuzzlewit 


Kartoniert 


813 


1998 


4 


13 9 


>351-03044-4 


Dickens. Charles 


Weihnachten mit Dickens 


Gebunden 


160 


2005 


3 


10 


3458-32655-3 


Dickens. Charles 


Horte Zeiten 


Kartoniert 


433 


2004 


6 


11.5 


3-458-3273>9 


Dickens. Charles 


Geschichte aus zwei Städten 


Kartoniert 


505 


1987 


6 


12.5 


>450-32810-6 


Dickens. Charles 


Bleak House 


Kartoniert 


1030 


1988 


6 


17 


3-458-33004-6 


Dickens. Charles 


Nikolaus Nickleby 


Kartoniert 


1011 


1991 


6 


14 


3-491 -96007-X 


Dickens. Charles 


Weihnachtserzohlungen 


Gebunden 


591 


2000 


8 


9.95 


>538-05349-9 


Dickens. Charles 


David Copperfield 


Leinen 


1023 


1955 


2 


44 9 


>538-06656-6 


Dickens. Charles 


Die Pickwickjer 


Gebunden 


1039 


1997 


2 


12.9 


>538-06657-4 


Dickens. Charles 


Martin Chuzzlewit 


Gebunden 


1000 


1997 


2 


129 


3-538-06658-2 


Dickens, Charles 


Nicholas Nickleby 


Gebunden 


995 


1997 


2 


129 


3-538-06982-4 


Oickens. Charles 


Nicholas Nickleby 


Gebunden 


996 


2004 


2 


24.9 


3-71 75-1 976-X 


Dickens. Charles 


Das Geheimnis des Edwin Drood 


Leinen 


762 


2001 


7 


249 



Bild 2.7: 

Ausschnitt aus der 
Tabelle buch 
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Primärsch lüs&el 


Jede Tabelle enthält einen Primärschlüssel , der durch eine Spalte 
oder eine Kombination von mehreren Spalten repräsentiert wird. 
Der Wert des Primärschlüssels identifiziert höchstens eine Zeile 
der Tabelle. Die Schlüsselwerte einer Tabelle sind alle voneinan- 
der verschieden. Für die Tabelle buch bietet sich die Spalte isbn 
als Primärschlüssel an. 


Fremdsch l üssel 


Um Verknüpfungen zwischen Tabellen hersteilen zu können, 
werden so genannte Fremdschlüssel benötigt. 

Ein Fremdschlüssel einer Tabelle wird durch eine Spalte oder 
durch eine Kombination von mehreren Spalten repräsentiert. Ein 
Fremdschlüssel ist in einer anderen Tabelle Primärschlüssel. 
Durch Vergleich von Fremdschlüsselwert und Primärschlüssel- 
wert werden Beziehungen zwischen Zeilen der beiden Tabellen 
hergestellt. 

So hat die Tabelle buch den Primärschlüssel isbn , die Tabelle 
vertag den Primärschlüssel verlag_id. Die Tabelle buch besitzt 
den Fremdschlüssel verlag_id (siehe Tabellenstruktur weiter 
unten). 

Fremdschlüsselwerte innerhalb einer Tabelle sind in der Regel 
natürlich nicht eindeutig. Die l:n-Beziehung zwischen vertag 
und buch sowie wird also durch die Fremdschlüssel-Primär- 
schlüssel-Beziehung etabliert. 

Im Weiteren setzen wir Grundkenntnisse der Datenbanksprache 
SQL voraus. Die SQL-Anweisungen zur Erstellung der drei Tabel- 
len für das Datenbanksystem MySQL sind: 


Tabelle Verlag 


create table vertag ( 
verlag_id integer, 
verlag_name varchar(30), 
webadresse varchar(30), 
primary key (verlag_id) 

) 


Tabelle buch 


create table buch ( 
isbn varchar(17), 
autor varchar(30), 
titel varcharf 80), 
ausgabe varchar(20), 

Seitenzahl integer, 
jahr integer, 
verlag_id integer, 
preis double, 
bestand integer, 
stand datetime, 
primary key (isbn) , 

foreign key (verlag_id) references vertag (verlag_id) 



) 



2.2 Erste Beispiele 
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Die Programme dieses Kapitels wurden mit verschiedenen Da- 
tenbanksystemen getestet. Es wurden solche Systeme bevorzugt, 
die weit verbreitet bzw. ohne allzu großen Aufwand installiert 
werden können. Die folgende Tabelle führt die Datenbankpro- 
dukte und eingesetzten JDBC-Treiber mit dem Produktnamen 
und der Version auf. Bezugsquellen können am Ende des Bu- 
ches nachgeschlagen werden. 



DBMS 


JDBC-Treiber 


Typ 


Microsoft Access 


JDBC-ODBC-Bridge 2.0001 


1 


MySQL Community 
Server 5.0.26 


MySQL Connector/J 5.0.4 


4 


Apache Derby 10.2.1.6 


Apache Derby Network Client 
JDBC Driver 10.2.1.6 


4 



Eingesetzte 
DB-Produkte 
lind JDBC-Treiber 



Access, MySQL (mit Tabellentyp InnoDB) und Apache Derby 
unterstützen Transaktionen (siehe Kapitel 2.4.1) und stellen die 
referentielle Integrität sicher. 

Das Java SE 6 Development Kit (JDK) enthält Apache Derby un- Java DB in JDK 6 
ter der Bezeichnung Java DB. 



2.2.2 Verbindungsaufbau 

Alle Programme sind so geschrieben, dass die Datenbanksysteme 
leicht gewechselt werden können. Dazu sind die datenbank- 
spezifischen Angaben in einer Konfigurationsdatei dbconnect. 
properties ausgelagert, die mit dem Texteditor bearbeitet werden 
kann. 

In diesem Abschnitt zeigen wir den grundsätzlichen Aufbau einer 
JDBC-Anwendung. Wir setzen voraus, dass die Datenbank be- 
reits eingerichtet ist und Testdaten enthält. In den folgenden 
Abschnitten dieses Kapitels werden dann der Aufbau und das 
Laden von Datenbanken mittels JDBC-Programmen ausführlich 
beschrieben. SQL-Skripte und Testdaten können der zum Down- 
load zur Verfügung gestellten Programmsammlung (Online- 
Service) entnommen werden. 



Das erste Programmbeispiel gibt Informationen über die benutz- Programm 2.1 
te Datenbank und das eingesetzte DBMS aus. Datenbankspezifi- 
sche Angaben (Treiber, Identifikation der Datenbank, User-Id 
und Passwort) befinden sich in der Datei dbconnect. properties-. 
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dbconnect. 

properties 



DBMetaData 



# MS Access 

driver=sun . jdbc . odbc . JdbcOdbcDriver 

url= jdbc : odbc : buecher 

user= 

password= 

# MySQL 

#driver=com.mysql . jdbc . Driver 
#url= jdbc :mysql : //localhost /buecher 
#user=root 
#password=root 

# Apache Derby 

#driver=org . apache . derby . jdbc . ClientDriver 
#url= jdbc : derby : //localhost /buecher 
#user=root 
#password=root 



Hier sind die Angaben zur Access-Datenbank aktiviert. Das Zei- 
chen # leitet einen Kommentar ein. Die Access-Datenbank muss 
mit dem Namen buecher als ODBC-Datenquelle registriert sein. 
Bei Windows muss zu diesem Zweck das Programm Datenquel- 
len (ODBC) aus der Systemsteuerung aufgerufen und der MS- 
Access-Treiber sowie die Acess-Datenbank ausgewählt werden. 



import java.sql.*; 
import java.io.*; 
import java.util.*; 

public dass DBMetaData { 

public static void main (String [ ] args) throws Exception ( 

// DB-Parameter einiesen 

FilelnputStream in = new FileInputStream( "dbconnect .properties") ; 
Properties prop = new Properties ( ) ; 
prop.load(in) ; 
in . close ( ) ; 

String driver = prop . getProperty ( "driver " ) ; 

String url = prop. getProperty ("url") ; 

String user = prop . getProperty ( "user " ) ; 

String password = prop. getProperty ("password") ; 

// Treiber laden 
Class . forName (driver) ; 

// Verbindung zur DB hersteilen 

Connection con = DriverManager . getConnection (url, user, password); 

DatabaseMetaData dtmd = con . getMetaData ( ) ; 

System, out. printin ("URL: " + dkmd.getURL () ) ; 

System. out. printin ("UserName: " + dbmd.getUserName () ) ; 

System. out. printin ("DatabaseProductName: " + 
dbmd.getDatabaseProductName () ) ; 

System. out. printin ("DatabaseProductVersion: " + 
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dbmd.getDatabaseProductVersionO ) ; 

System. out. printin ( "DriverName : " + dfcmd.getDriverNameO); 
System, out .printin ("DriverVersion: " + dfcmd.getDriverVersion () ) ; 

con . close ( ) ; 

} 

} 



Zunächst werden die Verbindungsparameter aus dbconnect. 
properties eingelesen und in entsprechenden Variablen abgelegt. 

Die Treiberklasse (im Beispiel sun. jdbc. odbc. JdbcOdbcDriver für 
Access, ccm. my sql. jdbc. Driver für MySQL und org.apache.derby. jdbc. 
ClientDriver für Apache Derby) wird mit Class . f orName ( . . . ) explizit 
geladen. Hierbei wird ein statischer Initialisierungsblock der 
Treiberklasse ausgeführt, der dafür sorgt, dass eine neue Instanz 
des Treibers beim Treibermanager (java.sqi.DriverManager) regist- 
riert wird. 

Sicherzustellen ist, dass die Klassen des JDBC-Treibers, zusam- 
mengefasst in einer Datei (Z.B. mysql-comector-java-5.0.4-bin. jar) 
vom Class-Loader gefunden werden. Für unsere Beispiele wird 
der JDBC-Treiber in das Unterverzeichnis jre\iit>\ext des Java- 
Installationsverzeichnisses kopiert ("installiertes optionales Pa- 
ket"). Die Dokumentation zum jeweiligen Treiber gibt den Na- 
men der zu ladenden Klasse an. 



Um eine Verbindung zur Datenbank aufbauen zu können, muss 
diese Datenbank genau identifiziert werden. Die Zieldatenbank 
wird in URL-Schreibweise angegeben: 

jdbc : <subprotokoll> : <subname> 

Hierbei bezeichnet das Subprotokoll die Art des verwendeten 
Treibers (z.B. odbc, mysqi oder derby), Subname bezeichnet die 
eigentliche Datenbank. Bei Access ist das der Name der ODBC- 
Datenquelle, bei MySQL und Apache Derby ein URL (Uniform 
Resource Locator): //locaihost/buecher. Die Datenbank liegt hier 
auf dem eigenen Rechner. Statt locaihost kann auch der Name 
eines im Netz verbundenen anderen Rechners angegeben sein. 
Die Dokumentation zum Treiber enthält, was als Subprotokoll 
und Subname anzugeben ist. 

Im Fall einer Access-Datenbank kann die Datenbankdatei auch 
direkt eingetragen werden, ohne sie im ODBC-Datenquellen- 
Administrator zu registrieren. 

Beispiel (in einer Zeile zu erfassen): 

jdbc: odbc :Driver= {Microsoft Access Driver (*.mdb)}; 

DBQ=. ./db/Access/buecher.mdb 



JDBC-Treiber laden 



Verbindung zur 

Datenbank 

herstellen 
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DriverMa nager 


Die Klasse java.sqi.DriverManager kann unterschiedliche Treiber 
zur selben Zeit handhaben. Wird eine Verbindung zu einer Da- 
tenbank angefordert, so versucht der Treibermanager, den pas- 
senden Treiber zu finden und zur Herstellung der Verbindung zu 
verwenden. 

Die DriverManager-Methode getconnection stellt eine Verbindung zur 
Datenbank her. 

static Connection getConnection (String url) throws SQLException 

static Connection getconnection (String url, Properties info) 
throws SQLException 

static Connection getconnection ( 

String url, String user, String password) throws SQLException 

Alle Methoden liefern ein Connection-Objekt und erwarten einen 
URL und ggf. weitere Angaben als Parameter. Datenbank-User 
und Passwort können angegeben werden. Bei der zweiten Me- 
thode sind die zusätzlichen Verbindungsparameter user und pass- 
word im Properties-Objekt info eingetragen. 


SQLException 


Fehler werden in JDBC grundsätzlich als Ausnahmen der Klasse 
java . sql . SQLException ausgelöst. 


Connection 


Ein Objekt vom Schnittstellentyp java. sql. Connection repräsentiert 
eine Verbindung zur Datenbank. 

Ein SQL-Anweisungsobjekt wird über die Connection-Schnittstelle 
erzeugt: 

Statement createStatement () throws SQLException 

Eine aktive Verbindung zur Datenbank wird mit der Methode 
dose geschlossen: 

void close() throws SQLException 

Der Zustand einer Verbindung kann abgefragt werden: 

boolean isClosedQ throws SQLException 


Data baseMetaDa ta 


Das Interface DatabaseMataData repräsentiert Informationen über 
die Datenbank und das DBMS. 

Die folgende Connection-Methode liefert ein Metadaten-Objekt: 

DatabaseMetaData getMstaData ( ) throws SQLException 

Die Schnittstelle umfasst weit über 100 Methoden. Hier werden 
nur einige aufgeführt, die auch im nächsten Beispiel verwendet 
werden. 

String getURL() throws SQLException 

liefert den URL der Datenbank. 
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String getUserName ( ) throws SQLException 

liefert den Namen des Datenbank-Users. 

String getDatabaseProductName ( ) throws SQLException 

liefert den Produktnamen des Datenbanksystems. 

String getDatabaseProductVersion() throws SQLException 

liefert die Version des Datenbanksystems. 

String getDriverName () throws SQLException 

liefert den Namen des JDBC-Treibers. 

String getDriverVersion ( ) throws SQLException 

liefert die Version des JDBC-Treibers. 

mkdir build 

javac -sourcepath src -d build src/DBMetaData. java 
java -cp build DBMetaData 



Ausgabe: 

URL: jdbc:odbc:buecher 
UserName : admin 
DatabaseProductName : ACCESS 
DatabaseProductVersion : 04.00.0000 
DriverName: JDBC-ODBC Bridge (ODBCJT32.DLL) 
DriverVersion: 2.0001 (04.00.6019) 



2.2.3 SELECT-Abfragen auswerten 

Das Grundgerüst einer typischen JDBC-Anwendung besteht aus 
den folgenden Schritten: 

f . JDBC-Treiber laden 

2. Verbindung zur Datenbank hersteilen 

3. SQL-Anweisungsobjekt erzeugen 

4. SQL-Anweisung ausführen 

5. Ergebnisse der SQL-Anweisung verarbeiten 

6. Ressourcen freigeben 



Das zweite Programmbeispiel zeigt Informationen zu Büchern in 
Form einer sortierten Liste an. Die hierzu nötige SQL-Anweisung 
lautet: 

select autor, titel, isbn frcm buch Order by autor, titel 



Test 



AitflMu einer 
JDBC-Anwendung 



Programm 2.2 
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Buecherlistel 



Statement 



import java.sql.*; 
inport java.io.*; 
inport java.util.*; 

public dass Buecherlistel { 

public static void main (String [ ] args) throws Exception ( 

// DB-Parameter einiesen 

FilelnputStream in = new FileInputStream("dbconnect .properties") ; 
Properties prop = new Properties ( ) ; 
prop.load(in) ; 
in . close ( ) ; 

String driver = prop . getProperty ( "driver " ) ; 

String url = prop. getProperty ("url") ; 

String user = prop . getProperty ( "user " ) ; 

String password = prop. getProperty ("password") ; 

// Treiber laden 
Class . forName (driver) ; 

// Verbindung zur DB hersteilen 

Connection con = DriverManager . getConnection (url, user, password); 

// SQL-Abfrage ausführen 

Statement stmt = con . createStatement ( ) ; 

ResultSet rs = stmt.executeQuery ( 

"select autor, titel, isbn from buch Order by autor, titel"); 

// Ergebnisse ausgeben 
while (rs.nextQ) { 

System. out. println(rs.getString(l) ) ; 

System. out. printin (rs.getString (2) ) ; 

System. out .printin ("ISBN " + rs .getString(3) ) ; 

System, out .printin ( ) ; 

} 



rs . close ( ) ; 
stmt . close ( ) ; 
con. close () ; 




Das Interface java.sql. Statement ist die Basisschnittstelle für alle 
SQL- Anweisungsformen. 

Mit der Statement-Methode executeQuery wird eine SELECT- 
Anweisung ausgeführt: 

ResultSet executeQuery (String sql) throws SQLException 

Die Methode liefert ein Resuitset-Objekt mit dem Abfrage- 
ergebnis. Die SQL-Anweisung sql enthält kein Abschlusszeichen 
wie z.B. Solche Abschlusszeichen können von DBMS zu 
DBMS variieren und werden demzufolge vom Treiber gesetzt. 
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void close () throws SQLException 

gibt die mit der Ausführung gebundenen Ressourcen frei. Hier- 
durch wird auch das evtl, vorhandene Resuitset-Objekt geschlos- 
sen. 



Das Ergebnis einer SQL-Abfrage (eine Relation mit Zeilen und ResultSet 
Spalten) wird durch ein Objekt mit der Schnittstelle ResultSet 
repräsentiert. 

Zum Navigieren über die Zeilen der Ergebnismenge wird die 
Resuitset-Methode next genutzt: 

boolean next ( ) throws SQLException 

Ein interner Cursor zeigt auf die aktuelle Ergebniszeile. Zu Be- 
ginn ist der Cursor vor der ersten Zeile positioniert, next liefert so 
lange true, wie das Weitersetzen des Cursors erfolgreich war. Ist 
die Ergebnismenge leer oder das Tabellenende erreicht und 
keine weitere Zeile mehr vorhanden, so wird faise zurückgelie- 
fert. 

void close () throws SQLException 

gibt die genutzten Ressourcen frei. 



Nachdem der interne Cursor auf eine Ergebniszeile positioniert Spaltenzugriff 
wurde, kann auf die Spaltenwerte dieser Zeile von links nach 
rechts zugegriffen werden. 

Für den Spaltenzugriff existieren verschiedene Resuitset- 
Methoden getxxx. Es kann über den Spaltenindex, der bei 1 be- 
ginnt, oder über den Spaltennamen zugegriffen werden. Zu be- 
achten ist, dass der Spaltenindex sich auf die Spaltennummer in 
der Ergebnismenge und nicht in der Originaltabelle bezieht. 

getstring liefert den Spaltenwert als ein string-Objekt: 

String getstring (int columnlndex) throws SQLException 
String getstring (String columnName) throws SQLException 



Programmausgabe : 

Dickens, Charles 
Bleak House 
ISBN 3-458-32810-6 

Dickens, Charles 

Bleakhaus 

ISBN 3-257-2 11 66-X 

Dickens, Charles 

Das Geheimnis des Edwin Drood 

ISBN 3-7175-1 97 6-X 
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Programm 23 


Im Unterschied zu Programm 2.2 wird im folgenden Programm 
auch der Verlag eines Buches ausgegeben: 

Dickens, Charles 
Bleak House 

ISBN 3-458-32810-6 Insel 


Buecherliste2 

(Ausschnitt) 


Die SQL-Anweisung enthält einen so genannten Join zwischen 
den Tabellen buch und Verlag. 

// SQL-Abfrage ausführen 

Statement stmt = con . createStatement ( ) ; 

ResultSet rs = stmt.executeQuery ( 

"select autor, titel, isbn, verlag_name " + 

"from buch inner join vertag " + 

"on buch.verlag_id = vertag. verlag_id " + 

"Order by autor, titel"); 

// Ergebnisse ausgeben 
white (rs.nextO) { 

System. out. println(rs.getString(l) ) ; 

System, out. printin (rs.getString (2) ) ; 

System. out .printin ("ISBN " + rs .getString(3) + " " + 
r s . getString (4) ) ; 

System, out .printin ( ) ; 

} 


Programm 2.4 


Mit dem folgenden Programm kann gezielt nach einem Titel 
gesucht werden. Dazu muss als Kommandozeilenparameter der 
Titel oder nur ein Teil des Titels beim Aufruf angegeben werden. 

Beispiel: 

java -cp build Buecherliste3 Nickleby 


Buecherliste3 

(Ausschnitt) 


Statement stmt = con . createStatement () ; 

ResultSet rs = stmt.executeQuery ( 

"select autor, titel, isbn, verlag_name " + 

"from buch inner join verlag " + 

"on buch.verlag_id = verlag. verlag_id " + 

"where titel like '%" + titel + "%' order by autor, titel"); 




2.3 JDBC-Datentypen 

Bei den SQL-Datentypen, die von den verschiedenen Datenbank- 
systemen unterstützt werden, gibt es zum Teil erhebliche Unter- 
schiede. 

SQL arbeitet mit anderen Datentypen als Java. Beim Zugriff auf 
die Spaltenwerte und bei der Belegung von Parametern in JDBC- 
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Programmen (siehe Preparedstatement im nächsten Abschnitt) muss 
daher eine Abbildung zwischen beiden Typsystemen erfolgen. 

Um die am meisten verwendeten SQL-Datentypen einheitlich zu JDBC-Datentypen 
repräsentieren, wurden so genannte JDBC-Datentypen definiert, 
die in der Klasse java.sqi.Types als Konstanten vom Typ int zu- 
sammengefasst sind: 

public static final int XXX 

Bilcl 2.8 gibt eine Übersicht über die JDBC-Datentypen und ihre 
Entsprechungen für die Datenbanksysteme Access, MySQL und 
Apache Derby. 

Beim Lesen der Werte aus einem Resuitset-Objekt bzw. bei der 
Übergabe von Parametern an ein Preparedstatement (siehe nächs- 
ten Abschnitt) werden getxxx- bzw. setxxx-Methoden verwendet. 

Hier findet eine Konvertierung von SQL-Typen in Java-Typen 
bzw. umgekehrt statt. Bild 2.9 zeigt die Abbildung zwischen 
JDBC-Typen und Java-Typen. 

Bild 2.8: 

Abbildung zwischen 
JDBC-Typen und 
SQL-Typen 



JDBC-Typ 


SQL-Typ Access 


SQL-Typ MySQL 


SQL-Typ Derby 


Integerzahlen 


TINYINT 


BYTE 


TINYINT 




SMALLINT 


SMALLINT 


SMALLINT 


SMALLINT 


INTEGER 


INTEGER, COUNTER 


INTEGER, 

MEDIUMINT 


INTEGER 


BIGINT 




BIGINT 


BIGINT 


Gleit ko m m azah len 


REAL 


REAL 


FLOAT 


REAL 


FLOAT 








DOUBLE 


DOUBLE, FLOAT 


DOUBLE, REAL 


DOUBLE, FLOAT 


Festko m mazah len 


DECIMAL 




DECIMAL(p,s), 

NUMERIC(p,s) 


DECIMAL(p,s) 

NUMERIC(p,s) 


NUMERIC 


CURRENCY 
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JDBC-Typ 


SQL-Typ Access 


SQL-Typ MySQL 


SQL-Typ Derby 


Datum und Uhrzeit 


DATE 




DATE, YEAR 


DATE 


TIME 




TIME 


TIME 


TIMESTAMP 


DATE, TIME, 


TIMESTAMP, 


TIMESTAMP 




DATETIME 


DATETIME 





Zeichenketten 



CHAR 


CHAR(n) 


CHAR(n) 


CHAR(n) 


VARCHAR 


VARCHAR(n), TEXT 


VARCHAR(n) 


VARCHAR(n) 


LONGVARCHAR 


LONGCHAR, 

LONGTEXT 


TI NYTEXT, TEXT, 

MEDIUMTEXT, 

LONGTEXT 


LONG VARCHAR 



Binärdaten 



BIT 


BIT 


BOOLEAN 




BINARY 


BINARY(n) 




CHAR(n) FOR BIT 
DATA 


VARBINARY 


VARBINARY(n) 


TINYBLOB 


VARCHAR(n) FOR BIT 
DATA 


LONGVARBINARY 


LONGBINARY 


BLOB, 

MEDIUMBLOB, 

LONGBLOB 


LONG VARCHAR 
FOR BIT DATA 



Bild 2.9: 

Abbildung zwischen 
JDBC- und Java- 
Datentypen 



JDBC-Typ 


Java-Typ 


Java-Objekttyp 


TINYINT 


byte 


Integer 


SMALLINT 


short 


Integer 


INTEGER 


int 


Integer 


BIGINT 


long 


Long 


REAL 


f loat 


Float 


FLOAT 


double 


Double 


DOUBLE 


double 


Double 
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JDBC-Typ 


Java-Typ 


Java-Objekttyp 


DECIMAL 


java .math . BigDecimal 


java .math . BigDecimal 


NUMERIC 


java .math . BigDecimal 


java .math . BigDecimal 


DATE 


java . sql . Date 


java . sql . Date 


TIME 


java . sql . Time 


java . sql . Time 


TIMESTAMP 


java . sql . Timestamp 


java . sql . Timestamp 


CHAR 


String 


String 


VARCHAR 


String 


String 


LONGVARCHAR 


String 


String 


BIT 


boolean 


Boolean 


BINARY 


byte [ ] 


byte [ ] 


VARBINARY 


byte [ ] 


byte [ ] 


LONGVARBINARY 


byte [ ] 


byte [ ] 



Die get-Methoden der Klasse ResuitSet sind dann entsprechend: 

byte getByte(...) 
short getShort (...) 
int getlnt (...) 
long getLong(...) 
float getFloat (...) 
double getDouble (...) 

java.math.BigDecimal getBigDecimal (...) 

java.sql.Date getDate(...) 

java . sql . Time getTirte (...) 

java . sql . Timestamp getTimestairp (...) 

String getString (...) 
boolean getBoolean (...) 
byte [ ] getBytes (...) 

Beim Aufruf einer get-Methode ist als Parameter eine Spalten- 
nummer (Typ int) oder ein Spaltenname (Typ string) anzugeben. 

Alle get-Methoden können die Ausnahme SQtException auslösen. 
Die Resuitset-Methoden 

Object getCbject (int columnlndex) throws SQLException 
Object getCbject (String columnName) throws SQLException 

liefern den Spaltenwert als ein Java-Objekt, dessen Typ dem 
entsprechenden JDBC-Datentyp aus der obigen Tabelle (Bild 2.9) 
entspricht. So wird z.B. für einen Spaltenwert vom JDBC-Typ 
integer ein Objekt vom Typ integer geliefert. 
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Datum/Zeit 



Date 



Time 



Timestamp 



Die Klassen Date, Time und Timestamp des Pakets java.sqi sind Sub- 
klassen von java.utii.Date und repräsentieren die JDBC-Daten- 
typen date, time und timestamp. Objekte dieser Klassen enthalten 
Datumsangaben, Uhrzeitangaben bzw. Angaben zu Datum und 
Uhrzeit. 



Date(long date) 

erzeugt ein Date-Objekt mittels des Zeitwerts date in Milli- 
sekunden (seit 01.01.1970, 00:00:00 GMT). 

void setTime(long date) 

setzt das Datum. 

static Date valueOf (String s) 

liefert ein Date-Objekt aus der Zeichenkette s im Format " jjjj-mm- 

tt". 

String toStringO 

liefert eine Zeichenkette im Format " jjjj-nm-tt" . 



Time(long time) 

erzeugt ein Time-Objekt mittels des Zeitwerts time in Milli- 
sekunden (seit 01.01.1970, 00:00:00 GMT). 

void setTime(long time) 

setzt die Uhrzeit. 

static Time valueOf (String s) 

liefert ein Time-Objekt aus der Zeichenkette s im Format 
"hhiimuss". 

String toStringO 

liefert eine Zeichenkette im Format "hh:mm:ss". 



Timestanp ( long time) 

erzeugt ein TimestamE>Objekt mittels cles Zeitwerts time in Milli- 
sekunden (seit 01.01.1970, 00:00:00 GMT). 

void setTime(long time) 

setzt Datum und Uhrzeit. 

long getTime() 

liefert Datum und Uhrzeit in Millisekunden (seit 01.01.1970, 
00:00:00 GMT). 

static Timestamp valueOf (String s) 

liefert ein Timestanp-Objekt aus der Zeichenkette s im Format 
" jjj j-mm-tt hh:mm:ss.f", wobei f die Nanosekunden bezeichnet. 

String toStringO 

liefert eine Zeichenkette im Format " jjjj-mm-tt hh:nm: ss.f". 

boolean after (Timestamp ts) 

prüft, ob diese Uhrzeit später als ts ist. 
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boolean before (Timestamp ts) 

prüft, ob diese Uhrzeit früher als ts ist. 

int ccmpareTo (Timestamp ts) 

vergleicht diese Uhrzeit mit ts. 

boolean equals (Timestamp ts) 

prüft, ob dieses Timestan?rObjekt inhaltlich gleich dem Timestairp- 
Objekt ts ist. 



2.4 Ausführung von SQL-Anweisungen 

In diesem Abschnitt beschäftigen wir uns mit der Änderung von 
Datenbankstrukturen und -inhalten, der Abfrage von Metadaten 
über Ergebnismengen zur Laufzeit und mit der Schnittstelle 

PreparedStatement. 

2.4.1 Transaktionen 

Im Fall von Änderungen steht der Begriff der Transaktion im 
Vordergrund. 

Eine Transaktion ist eine Folge von Datenbankoperationen Transaktion 
(SQL-Anweisungen), die die Datenbank von einem konsistenten 
Zustand in einen neuen konsistenten Zustand überführen. Die 
Anweisungen einer Transaktion werden entweder alle ausgeführt 
und abgeschlossen ( committed) oder alle zurückgenommen 
( rolled back). 

Transaktionen können automatisch oder manuell gesteuert wer- 
den. Eine JDBC-Anwendung ist standardmäßig im Auto-Commit- 
Modus-. Jede einzelne SQL-Anweisung bildet eine Transaktion, 
die automatisch mit Commit bestätigt wird. 

Um mehrere Anweisungen innerhalb einer einzigen Transaktion 
ausführen zu können, muss Auto-Commit ausgeschaltet werden. 

Das Interface Connection deklariert Methoden zur Steuerung von 
Transaktionen. 



void setAntoCcranit (boolean autoCammit) throws SQLException Auto-Commit 

schaltet Auto-Commit ein (true) oder aus (faise). 

boolean getAutoCcnmit ( ) throws SQLException 

prüft, ob Auto-Commit eingeschaltet ist. 



void ccmmito throws SQLException Commit und 

zeigt an, dass die Transaktion abgeschlossen werden soll und Rollback 
alle Änderungen in der Datenbank permanent gespeichert wer- 
den sollen. 
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Programm 2.5 



tables. properties 



CreateTables 



void rollback() throws SQLException 

bricht die aktive Transaktion ab, alle bisherigen Änderungen 
innerhalb dieser Transaktion werden rückgängig gemacht. 

Transaktionen werden automatisch begonnen. Die erste SQL- 
Anweisung nach einem Com mit oder Rollback gehört schon zu 
einer neuen Transaktion. Eine manuell gesteuerte, noch nicht 
abgeschlossene Transaktion wird explizit mit der Methode 
conmit oder roiiback geschlossen. 

2.4.2 Datenbankänderungen 

SQL-Anweisungen, die die Datenbankstruktur betreffen (z.B. 
CREATE TABLE) und die Änderungsbefehle INSERT, UPDATE 
und DELETE werden mit Hilfe der folgenden Statement- 
Methode an die Datenbank geschickt: 

int executeüpdate (String sql) throws SQLException 

Im Fall von INSERT, UPDATE oder DELETE liefert die Methode 
die Anzahl der von der Änderung betroffenen Zeilen. 



Programm 2.5 richtet die im Kapitel 2.2 eingeführten Tabellen 
verlag und buch ein. Die Properties - Datei tables. properties enthält 
die Verweise auf die entsprechenden SQL-Skripte. 



tables . ./db/Access/create_verlag.sql \ 

. ./db/Access/create_buch.sql 

ttables . ./db/MySQL/create_verlag.sql \ 

# . . /db/MySQL/create_buch . sql 

#tables . ./db/Derby/create_verlag.sql \ 

# . . /db/Derby/create_buch . sql 

Das Programm ist unabhängig von einem konkreten Datenmo- 
dell und somit universell einsetzbar. 



import java.sql.*; 
import java.io.*; 
import java.util.*; 

public dass CreateTables { 

public static void main (String [ ] args) { 
Connection con = null; 
try { 

FilelnputStream in = new FilelnputStream ( 
"dbconnect. properties") ; 

Properties dbProp = new Properties ( ) ; 
dbProp . load (in) ; 
in.closeO ; 
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String driver = dbProp . getProperty ( "driver" ) ; 

String url = dbProp. getProperty ("url") ; 

String user = dbProp. getProperty ("user") ; 

String password = dbProp. getProperty ("password") ; 

Class . forName (driver) ; 

con = DriverManager.getConnection(url, user, password); 

in = new FilelnputStream ("tables. properties" ) ; 
Properties tablesProp = new Properties () ; 
tablesProp.load(in) ; 
in.closeO ; 

StringTokenizer tables = new StringTokenizer ( 
tablesProp. getProperty ("tables") ) ; 

while (tables .hasMoreTokens () ) { 

BufferedReader reader = new Buf feredReader ( 
new FileReader (tables .nextToken () ) ) ; 

String line; 

StringBuilder sb = new StringBuilder () ; 
while ((line = reader. readLine () ) != null) { 
sb . append (line) ; 

} 

reader. closeO ; 

Statement stmt = con . createStatement () ; 
stmt . executeUpdate (sb.toStringO ) ; 
stmt . close ( ) ; 



catch (Exception e) { 
System. err .printin (e) ; 

) 

finally ( 
try ( 

con. closeO ; 

> 

catch (SQLException e) { 
System. err .printin (e) ; 

) 




In vielen Datenbanksystemen (wie auch bei MySQL) wird eine 
Transaktion durch create table automatisch abgeschlossen. Des- 
halb bleibt hier Auto-Commit eingeschaltet. 
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Programm 2.6 

Importdatei 



Das folgende Programm ermöglicht das Laden von Tabellen aus 
externen Quellen. 

Die Importdatei enthält pro Zeile einen in die Tabelle einzutra- 
genden Datensatz, wobei die Spaltenwerte in der gleichen Rei- 
henfolge auftreten, in der die Tabellenspalten mit der SQL- 
Anweisung "CREATE TABLE" definiert wurden. Die Werte in der 
Datei sind durch ein Sonderzeichen (z.B. ; oder das Tabulator- 
zeichen), das in keinem der Werte enthalten sein darf, getrennt 
( Feldtrenner ). 

Beispiel: 

Die Importdatei für die Tabelle vertag hat den Inhalt: 

1 ; Anaconda ; \N 

2; Artemis & Winkler; www.patmos.de 
3 ; Aufbau; www . aufbau-verlag . de 
4 ; Diogenes ; www . diogenes . ch 



Feldtrenner ist hier ; . Evtl, nicht vorhandene Werte sind durch \n 
zu kennzeichnen. Diese entsprechen den NULL-Werten in der 
Datenbank. Jede Zeile enthält drei Werte, die den Spalten 
verlag_id, verlag_name und webadresse entsprechen. 

Es folgen einige Konventionen für die Notierung der Werte in 
der Importdatei: 

• Zeichenketten werden ohne Begrenzer wie z.B. " usw. ein- 
gegeben. 

• Numerische Werte werden wie Literale in Java notiert. 

• Nicht vorhandene Werte (NULL-Werte) werden durch \n ge- 
kennzeichnet. 

• Formate für Datum, Uhrzeit und Zeitstempel sind " jjjj-mm-tt", 
n hh:nm:ss" bzw. "jjjj-mm-tt bh:mm:ss". 



Das Programm ist allgemeingültig geschrieben und kann zum 
Laden beliebiger Tabellen genutzt werden. Es wird mit drei Pa- 
rametern aufgerufen: 

1. Name des Verzeichnisses, in dem sich die Importdateien be- 
finden (" . " kennzeichnet das aktuelle Verzeichnis) 

2. Feldtrenner, z.B. ; oder \t (falls das Tabulatorzeichen benutzt 
wurde) 

3. Name der Tabelle 

Der Name der Importdatei für die Tabelle xxx muss dann xxx.txt 
lauten. 
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Das Programm generiert für jede eingelesene Zeile der Import- 
datei eine INSERT-Anweisung. Da die Tabellenstruktur (insbe- 
sondere die verwendeten SQL-Datentypen) dem Programm zur 
Übersetzungszeit nicht bekannt ist, müssen Informationen hier- 
über zur Laufzeit abgefragt werden. 

Hierzu wird die Resuitset-Methode getMetaData verwendet, die ein 
ResuitsetMetaData-Objekt bereitstellt, das die gewünschten Infor- 
mationen enthält: 

ResultSetMetaData getMetaData ( ) throws SQLException 



Das Interface ResultSetMetaData deklariert u.a. Methoden, um den 
JDBC-Datentyp einer Spalte, die Anzahl der Spalten und einen 
Spaltennamen der Ergebnisrelation abzufragen. 

int getColumnType (int column) throws SQLException 

int getColumnCount ( ) throws SQLException 

String getColumnLabel (int column) throws SQLException 



import java.sql.*; 
import java.io.*; 
import java.util.*; 

public dass Import { 

public static void main( String [] args) { 

String dir = args[0]; 

String delimiter = args[l]; 

String table = args [2]; 

if (delimiter . equals ( " \\t " ) ) 
delimiter = "\t"; 

BufferedReader tab = null; 

Connection con = null; 
try { 

tab = new BufferedReader ( 

new FileReader (dir + "/" + table + ".txt")); 

FilelnputStream in = new FilelnputStream ( 

"dbconnect .properties" ) ; 

Properties prop = new Properties () ; 
prop.load(in) ; 
in.closeO ; 

String driver = prop.getProperty ("driver") ; 

String url = prop.getProperty ("url") ; 

String user = prop.getProperty ("user") ; 

String password = prop.getProperty ("password") ; 

Class . forName (driver) ; 

con = DriverManager.getConnection(url, user, password); 
con . setAutoCommit (false) ; 

Statement stmt = con.createStatement () ; 



Rest t ItSetMetaData 



Import 
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// Ermittlung der Metadaten zur Feststellung der Spaltentypen 
ResultSet rs = stmt . executeQuery ( 

"select * frcm " + table + " where 0 = 1"); 
ResultSetMetaData rsmd = rs . getMetaData ( ) ; 

StringTokenizer st; 

String line; 

while ((line = tab . readLine ( ) ) != null) ( 
if (line.lengthO = 0) 
continue; 

st = new StringTokenizer (line, delimiter) ; 

StringBuilder sql = new StringBuilder ( 

"insert into " t table + " values ("); 

String s; 
int i = 0; 

while (st.hasMoreTokens () ) { 
i++; 

s = st.nextTokenO ; 

sql.append(getValue(rsmd.getColumnType(i) , s) ) ; 
if ( st. count Tokens () != 0) 
sql.append(", ") ; 

} 

sql.append(") ") ; 

stmt.executeüpdate(sql.toString() ) ; 

) 



stmt.closeO ; 
con . canrriit () ; 

System. out .printin ("Daten wurden in Tabelle + table + 
importiert"); 

} 

catch (Exception e) { 

System. err. printin (e) ; 
try { 

if (con != null) 
con.rollback() ; 

} 

catch (SQLException ex) ( 

System. err. printin (ex) ; 



finally { 
try { 

if (con != null) 
con.close () ; 
if (tab != null) 
tab.close () ; 

} 

catch (Exception e) { 
System. err .printin (e) ; 
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// typgerechte Aufbereitung der Spaltenwerte für INSERT 
private static String getValue (int type, String s) { 

// aus \N wird null 
if (s.equals ("\\N") ) 
retum "null"; 

eise if (type = Types.CHAR | | type = Types . VARCHAR | | 
type = Types. LONGVARCHAR) { 

// der einfache Anführungsstrich 1 wird verdoppelt 
s = s.replaceAll (" ' ", 
retum " ' " + s + " ' " ; 

> 

eise if (type = Types. DATE) 
retum "{d '" + s + 
eise if (type = Types. TIME) 
retum "{t '" + s + 
eise if (type = Types. TIMESTAMP) { 

// bei Access entsprechen die SQL-Typen DATE, TIME, DATETIME 
// alle dem JDBC-Typ TIMESTAMP 
if (s.indexOfC ') != -1) 
retum "<ts + s + 
eise if (s.indexOfC-') != -1) 
retum "(d '" + s + 
eise 

return "(t + s + 



eise 

retum s; 



Um Informationen über die JDBC-Datentypen der Tabellen- 
spalten zu erhalten, wird zunächst eine SQL-Abfrage der Form 

select * from tabeile where 0=1 

ausgeführt, die eine leere Ergebnismenge liefert. 

Die ResuitSet-Methode getMetaData liefert dann ein ResuitsetMeta- 
Data-Objekt. 

Mit Hilfe von stringTokenizer wird nun jede Zeile in ihre Werte 
zerlegt und die INSERT-Anweisung aufgebaut: 

insert into tabeile values (wertl, . . . ) 

Die Hilfsmethode getValue (int type, String s) sorgt für die SQL- 
konforme Aufbereitung des eingelesenen Wertes. Hier liegen die 
folgenden Regeln zugrunde: 

Ist s gleich "\n", so liefert die Methode "null" zurück. 

Ist der JDBC-Typ type gleich char, varchar oder longvarchar, wird 
der Wert in einfache Hochkommata eingeschlossen. Ein einfa- 
ches Hochkomma ' im Wert selbst wird verdoppelt. 

Ist type gleich date, time oder timestamp, so werden Escape- 
Klauseln der Form {d 'xxx'}, (t 'xxx'} bzw. <ts 'xxx'} zurück- 
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geliefert, wobei xxx für das Literal für Datum, Zeit bzw. Zeit- 
stempel steht (siehe obige Beschreibung der Importdatei). 


Test 


Wegen der bestehenden Fremdschlüssel-Primärschlüssel-Be- 
ziehung müssen die Tabellen in der folgenden Reihenfolge gela- 
den werden: 

java -cp build Inport . ; verlag 
java -cp build Import . ; buch 


Batch-Updates 


Mehrere INSERT- oder UPDATE-Anweisungen können in einem 
Statement-Objekt mit addBatch gesammelt werden und dann in 
einem Zug mit executeBatch ausgeführt werden. Diese Vorge- 
hensweise ist in der Regel effizienter als die einzelne Ausführung 
von SQL-Anweisungen. 

Hier die beiden Statement-Methoden: 

void addBatch (String sql) throws SQLException 
int[] executeBatch ( ) throws SQLException 

Das int-Array enthält für jede SQL-Anweisung die Angabe dar- 
über, wie viele Datensätze eingefügt bzw. verändert wurden, den 
Wert Statement. SUCCESS_NO_INFO oder Statement. EXECUTE_FÄILED im 
Fehlerfall. 


Programm 2.7 


Das nächste Programm exportiert die Daten einer Tabelle im 
oben beschriebenen Import-Format. Damit können die Daten der 
Datenbank in einem Textformat gesichert werden. 


Export 


import java. sql.*; 
import java. io.*; 
import java.util.*; 

public dass Export { 

public static void main (String [ ] args) { 
String dir = args[0]; 

String delimiter = argstl]; 

String table = args [2]; 

if (delimiter. equals ("\\t") ) 
delimiter = "\t"; 

PrintWriter out = null; 

Connection con = null; 
try { 

out = new PrintWriter (new FileWriter( 
dir + "/" + table + ".txt"), true) ; 

FilelnputStream in = new FilelnputStream ( 
"dbconnect. properties") ; 

Properties prop = new Properties () ; 
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prop.load(in) ; 
in.closeO ; 

String driver = prop.getProperty ("driver") ; 

String url = prop.getProperty ("url") ; 

String user = prop.getProperty ("user") ; 

String password = prop.getProperty ("password") ; 

Class . forName (driver) ; 

con = DriverManager.getConnection(url, user, password); 
Statement stmt = con . createStatement ( ) ; 

ResultSet rs = stmt . executeQuery ("select * from " + table); 
ResultSetMetaData rsmd = rs . getMetaData ( ) ; 
int n = rsmd.getColumnCount () ; 

while (rs.nextO) { 

for (int i = 1; i <= n; i++) { 

String value = rs.getString(i) ; 
if (rs.wasNullQ ) 
out. print ("\\N") ; 
eise { 

out .print (value) ; 

) 

if (i < n) 

out .print (delimiter) ; 

} 

out .printin () ; 

} 



System. out .printin ("Tabelle + table + wurde exportiert"); 
stmt . close ( ) ; 

} 

catch (Exception e) { 

System, err .printin (e) ; 

} 

finally { 
try ( 

if (con != null) 
con . close ( ) ; 
if (out != null) 
out . close ( ) ; 

} 

catch (Exception e) { 

System. err. printin (e) ; 

} 




Um feststellen zu können, ob eine Spalte der Ergebnisrelation Nullwert abfragen 
keinen Eintrag hat (SQL-Wert null), muss zunächst mit einer 
getxxx-Methode auf die Spalte zugegriffen werden. Dann kann 
mit der folgenden Resuitset-Methode abgefragt werden, ob der 
letzte gelesene Wert ein Nullwert war: 



boolean wasNull () throws SQLException 
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Test 



setXxx 



java -cp build Export . ; buch 

Die Daten werden in der Datei buch.txt im aktuellen Verzeichnis 
gespeichert. 



2.4.3 Prepared Statements 

Wird ein und dieselbe SQL-Anweisung mehrfach (mit verschie- 
denen Parameterwerten) ausgeführt, so können Laufzeitvorteile 
dadurch erzielt werden, dass statt eines statement-Objekts ein 
Objekt vom Typ des Subinterfaces Preparedstatement verwendet 
wird. 

Ein PreparedStatement-Objekt wird durch Aufruf der Connection- 
Methode prepareStatement erzeugt: 

Preparedstatement prepareStatement (String sql) throws SQLException 

Der String sql wird zum DBMS geschickt, dort compiliert und für 
die Ausführung vorbereitet. 

Evtl. Parameterwerte werden in diesem String nicht angegeben, 
sondern nur durch den Platzhalter ? gekennzeichnet. Somit wird 
der String vom DBMS nur einmal geparst und auf Korrektheit 
geprüft. Bei jeder späteren Ausführung werden nur noch die 
Parameterwerte gefüllt. 



Analog zu den getxxx-Methoden von Resuitset (siehe Kapitel 2.3) 
stellt Preparedstatement setxxx-Methoden bereit, mit denen die Pa- 
rameterwerte gesetzt werden können. 

void setByte ( int idx, byte x) 

void setShort (int idx, short x) 

void setint (int idx, int x) 

void setLong(int idx, long x) 

void setFloat (int idx, float x) 

void setDouble (int idx, double x) 

void setBigDecdmal (int idx, BigDecimal x) 

void setDate(int idx, Date x) 

void setTiine(int idx, Time x) 

void setTimestarrp(int idx, Timestamp x) 

void setString (int idx, String x) 

void setBoolean ( int idx, boolean x) 

void setBytes(int idx, byte[] x) 

idx kennzeichnet den zu ersetzenden Parameter mit Hilfe seiner 
Positionsnummer, von links nach rechts, beginnend mit 1. Alle 
set-Methoden können eine SQLException auslösen. 

void setCbject (int idx, Object value) throws SQLException 

setzt den Wert des Parameters an der Stelle idx mit Hilfe des 
Objekts obj. Dabei wird value in einen Wert des entsprechenden 
SQL-Typs konvertiert (siehe Bild 2.8 und 2.9). 
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Nullwerte können mit setNuii übergeben werden, wobei eine 
passende Konstante aus java.sqi.Types anzugeben ist: 

void setNull(int parameter Index, int sqlType) throws SQLException 

Das Interface Preparedstatement enthält auch die entsprechenden 
Methoden zur Ausführung der SQL-Anweisung: 

ResultSet executeQuery ( ) throws SQLException 
int executeUpdate ( ) throws SQLException 



Batch-Updates können auch mit Preparedstatement ausgeführt Batch-Updates 
werden. Mit Hilfe der PreparedStatement-Methode 

void addBatch ( ) throws SQLException 

werden Parametersätze, die mit den setxxx-Methoden angelegt 
wurden, eingetragen. 

Die einzelnen Operationen werden dann wieder am Schluss in 
einem Zug mit Hilfe der Methode executeßatch (siehe oben) aus- 
geführt. 



Das folgende Programm nutzt die eben behandelten Mög- Programm 2.8 
lichkeiten, um den Lagerbestand zu erhöhen bzw. zu vermin- 
dern. Die folgende UPDATE-Anweisung wird verwendet: 

update buch set bestand = bestand + ?, stand = ? where isbn = ? 

ISBN-Nummer und Mengenwert werden aus der Eingabedatei 
bestand.txt (Aufrufparameter) gelesen. 

Bild 2.10 zeigt den Datenbankzustand vor der Änderung. 



bestand.txt 



3 - 15 - 001308-9 


-5 


3 - 257 - 20998-3 


-4 


3 - 351 - 03044-4 


7 



' 












UpdateBestand 




DB 





isbn 


basfand 


3-15-001308-9 


12 


3-15-001562-6 


12 


3-15-010606-0 


20 


3-257-20998-3 


17 


3-257-21034-5 


55 


3-257-21 166-X 


8 


3-257-21 405-7 


33 


3-257-21406-5 


8 


3-351-03044-4 


25 


3-458-32655-3 


30 


3-458-32733-9 


15 


3-458-32810-6 


16 


3-458-33004-6 


20 


3-491 -96007-X 


10 


3-538-05349-9 


12 


3-538-06656-6 


22 



Bild 2.10: 

Update des 
Lagerbestands 
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UpdateBestand 



import java.sql.*; 
inport java.io.*; 
import java.util.*; 

public dass UpdateBestand { 

public static void main (String [ ] args) { 

String datei = args[0]; 

BufferedReader input = null; 

Connection con = null; 
try { 

input = new BufferedReader (new FileReader (datei) ) ; 

FilelnputStream in = new FilelnputStream ( 

"dbconnect. properties ") ■ 

Properties prop = new Properties () ; 
prop.load(in) ; 
in.closeO ; 

String driver = prop.getProperty ("driver") ; 

String url = prop.getProperty ("url") ; 

String user = prop . getProperty ( "user " ) ; 

String password = prop . getProperty ( "password" ) ; 

Class . forName (driver) ; 

con = DriverManager . getConnection (url, user, password); 
con . setAutoCommit (false) ; 

PreparedStatennent stmt = con.prepareStatement ( 

"update buch set bestand = bestand + ?, " + 

"stand = ? where isbn = ?"); 

String isbn; 
int bestand; 
int count; 

StringTokenizer st; 

String line; 

while ((line = input. readLine () ) != null) < 
st = new StringTokenizer (line) ; 
isbn = st . nextToken ( ) ; 

bestand = Integer. parseint (st. nextTokenf) ) ; 
stmt . set Int ( 1 , bestand) ; 
stmt.setTimestamp(2, new Timestamp( 

System. currentTimeMillis () ) ) ; 
stmt . setString (3, isbn) ; 
count = stmt.executeUpdate () ; 

if (count > 0) 

System. out. println(isbn + Bestand aktualisiert"); 

} 



con.ccmmit () ; 
stmt.close () ; 

} 

catch (Exception e) { 
System. err .printin (e) ; 
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try { 

if (con != null) 
con . rollback ( ) ; 

} 

catch (SQLException ex) { 
System, err .printin (ex) ; 



finally ( 
try { 

if (con != null) 
con . close ( ) ; 
if (input != null) 
input . close ( ) ; 

) 

catch (Exception e) { 
System. err .printin (e) ; 




2.5 Ein einfaches Frontend für SQL-Datenbanken 

In Kapitel 2.2 wurden bereits Metadaten über die Datenbank 
(DatabaseMetaData) genutzt. Hier folgen zwei weitere Methoden: 

ResultSet getTables (String catalog, String schemaPattern, 

String tableNamePattem, String [] types) throws SQLException 

liefert eine Beschreibung der Tabellen der Datenbank. Im Bei- 
spiel rufen wir die Methode mit den Parametern null, null, "%", 
null auf. Das Resuitset-Objekt enthält u.a. die Spalten table_name 

und TABI£_TYPE. 

ResultSet getColumns (String catalog, String schemaPattern, 

String tableNamePattem, String columnNamePattem) 
throws SQLException 

liefert eine Beschreibung der Tabellenspalten. Im Beispiel rufen 
wir die Methode mit den Parametern null, null, tabeile, "%" auf. 
Das Resuitset-Objekt enthält u.a. die Spalten colümn_name, data_type 
(JDBC-Datentyp aus java.sql. Types), TYPE_NAME, COLUMN_SIZE. 



Das folgende Programm bietet ein Frontend für SQL-Daten- Programm 2.9 
banken, mit dem beliebige SQL-Anweisungen (SELECT, INSERT, 

UPDATE, DELETE) an eine Datenbank geschickt werden kön- 
nen. 

Die Abfrageergebnisse können auf Wunsch in der Datei log.txt 
protokolliert werden. Das Programm bietet neben den SQL- 
Anweisungen noch die folgenden Eingabemöglichkeiten: 
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q 



Show tables 



Show table xxx 



log on 



log off 



alle Tabellennamen anzeigen 
Metadaten zur Tabelle xxx anzeigen 
Protokollierung einschalten 
Protokollierung ausschalten 
Programm beenden 



Unbekannte 

Anweisungen 

ausführen 



SQLException 



In diesem Programm nutzen wir die statement-Methode 
execute, um beliebige, zur Compilierungszeit unbekannte SQL- 
Anweisungen an die Datenbank zu schicken: 

boolean execute (String sql) throws SQLException 

Der Rückgabewert ist true, wenn ein Abfrageergebnis vorliegt, 
und faise, wenn es sich um eine Änderung handelt. 

Mit den beiden Statement-Methoden getResultSet und getUpdateCount 
kann die Ergebnismenge bzw. die Anzahl der geänderten Zeilen 
ermittelt werden: 

ResultSet getResultSet () throws SQLException 
int getUpdateCount ( ) throws SQLException 

Auch die Schnittstelle PreparedStatement enthält eine execute- 
Methode: 

boolean execute () throws SQLException 

Bei schwerwiegenden Fehlern melden die meisten JDBC- 
Methoden einen Fehler durch eine Ausnahme der Klasse 
java . sql . SQLException (Subklasse von Exception). Dabei können 
mehrere Fehlermeldungen in einem Objekt vom Typ SQLException 
verpackt sein. 

SQLException enthält folgende Methoden: 

String getSQLState ( ) 

liefert eine Fehlerbeschreibung nach X/OPEN- bzw. SQL99- 
Konventionen. 

int getErrorCode () 

liefert einen herstellerspezifischen Fehlercode. 

SQLException getNextException ( ) 

liefert das nächste Ausnahme-Objekt, falls mehrere Fehler- 
meldungen vorliegen. 



2.5 Ein einfaches Frontend für SQL-Datenbanken 
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import java.sql.*; 
import java.io.*; 
import java.util.*; 

public dass Sql { 

private static Connection con; 
private static boolean log; 
private static BufferedReader input; 
private static PrintWriter output; 

public static void main( String [] args) { 
try { 

FilelnputStream in = new FilelnputStream ( 

"dbconnect .properties" ) ; 

Properties prop = new Properties () ; 
prop.load(in) ; 
in.closeO ; 

String driver = prop.getProperty ("driver") ; 

String url = prop.getProperty ("url") ; 

String user = prop.getProperty ("user") ; 

String password = prop.getProperty ("password") ; 

Class . forName (driver) ; 

con = DriverManager.getConnection(url, user, password); 

input = new BufferedReader (new InputStreamReader (System. in) ) ; 
String query; 

while (true) < 

System.out. print ("> "); 
query = input . readLine ( ) ; 

if (query . equals ( "q" ) ) 
break; 

if (query. equals ("log on") ) { 
if (output = null) { 

output = new PrintWriter ( 

newFileWriterClog.txt"), true); 

) 

log = true; 
continue; 

} 



if (query. equals ("log off") ) { 
log = false; 
continue; 

} 



if (log) 

output .printin ("Query : " + query); 
try { 

process (query) ; 
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catch (SQLException e) { 
printSQLException (e) ; 



catch (Exception e) { 
System. err .printin (e) ; 

} 

finally { 
try { 

if (con != null) 
con.close () ; 
if (input != null) 
input . close ( ) ; 
if (output != null) 
output. close () ; 

> 

catch (SQLException e) { 
printSQLException (e) ; 

} 

catch (IOException e) { 
System. err .printin (e) ; 




private static void printSQLException (SQLException e) { 
System. err. printin ("SQLException: ") ; 
while (e != null) { 

System. err .printin ("SQLState: " + e.getSQLState () ) ; 
System. err. printin ("Message: " + e . getMessage ( ) ) ; 
System. err .printin ( "ErrorCode : " + e . getErrorCode ( ) ) ; 
e = e.getNextException() ; 

} 



private static void process (String query) throws SQLException ( 
if (query. equals ("Show tables") ) ( 
showTables () ; 
return; 

) 



if (query. startsWith( "show table ")) { 

String table = query. substring (11) .trirnQ; 

showTable (table) ; 

return; 



Statement stmt = con.createStatement () ; 

boolean isResultSet = stmt . execute (query) ; 
if (isResultSet) { 

ResultSet rs = stmt .getResultSet () ; 
ResultSetMetaData rsmd = rs . getMetaData ( ) ; 
int numCols = rsmd.getColumnCount () ; 
int count = 0; 
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while (rs.nextO) { 
count ++; 

System.out.printlnC# " + count) ; 
if (log) 

output .printin ("# " + count); 

for (int i = 1; i <= numCols; i++) { 

String line = rsmd.getColumnLabel (i) + ": " + 
rs .getString (i) ; 

System, out .printin (line) ; 
if (log) 

output .printin (line) ; 




if (log) 

output .printin ( ) ; 
rs.closeO ; 

) 

eise ( 

int updateCount = stmt . getUpdateCount ( ) ; 

System. out .printin ("UpdateCount: " + updateCount); 
if (log) ( 

output .printin ("UpdateCount: " + updateCount); 
output .printin ( ) ; 

) 



Stint. closeO ; 

} 



private static void showTablesO throws SQLException { 
DatabaseMetaData dtmd = con.getMetaDataO ; 

ResultSet rs = dtmd. get Tables (null, null, "%", null); 
String table, type; 

while (rs . next ( ) ) ( 

table = rs .getString ("TABLE_NAME") ; 
type = rs . getString ( "TABLE_TYPE " ) ; 

System. out .printin (type + ": " + table); 
if (log) 

output .printin (table) ; 

> 



if (log) 

output . printin ( ) ; 
rs . close ( ) ; 



private static void showTable (String table) throws SQLException { 
DatabaseMetaData dtmd = con.getMetaDataO ; 

ResultSet rs = dtmd. getColumns (null, null, table, "%"); 

String name, type, size; 
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Test mit MySQL- 
Datenbank 



while (rs.nextQ) { 

name = rs.getString("COLUMN_NAME") ; 
type = rs.getString("TYPE_NAME") ; 
size = rs.getString("COLUMN_SIZE") ; 

System. out .printin (name + " " + type + "(" + size + 
if (log) 

output. printin (name + " " + type + "(" + size + 

} 



if (log) 

output . printin ( ) ; 
rs . close ( ) ; 

} 

} 



java -cp build Sql 

> log on 

> show tables 
TAKLE: buch 
TABLE: verlag 

> show table buch 
isbn varchar(17) 
autor varchar(30) 
titel varchar(80) 
ausgabe varchar(20) 

Seitenzahl int (11) 
jahr int (11) 
verlag_id int (11) 
preis double (22) 
bestand int (11) 
stand datetime (19) 

> select * from buch where titel like '%Twist%' 

# 1 

isbn: 3-7466-2200-X 
autor: Dickens, Charles 
titel: Oliver Twist 
ausgabe: Kartoniert 
Seitenzahl: 564 
jahr: 2005 
verlag_id: 3 
preis : 9.95 
bestand: 50 

stand: 2006-08-20 00:00:00.0 

> log off 

> q 



2.6 Speicherung großer Objekte 
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2.6 Speicherung großer Objekte 

Wir wollen nun die Struktur der Tabelle buch um eine zusätzli- 
che Spalte, die ein Bild des Covers aufnehmen kann, ergänzen. 

Die hierfür geeignete SQL-Anweisung lauten: 

Access: alter table buch add bild longbinary 

MySQL: alter table buch add bild longblob 

Apache Derby: alter table buch add bild blob 



Mit Streams können die Daten blockweise geschrieben bzw. 
gelesen werden. 

PreparedStatement-Methode : 

void setBinaryStream (int Parameter Index, InputStream x, int length) 
throws SQLException 

length ist die Größe der Datei in Byte. 



Resuitset-Methoden: 

InputStream getBinaryStream(int columnlndex) throws SQLException 
InputStream getBinaryStream( String columnName) throws SQLException 



Programm 2.10 speichert ein jpeg-Bild für eine bestimmte ISBN- 
Nummer. Die Bilder sind in einem vorgegebenen Verzeichnis zu 
finden und tragen jeweils den Dateinamen: <isbn>.jpeg. 
Aufrufbeispiel: 

java -cp build Importimage bilder 3-15-001308-9 



import java.sql.*; 
import java. io.*; 
import java.util.*; 

public dass Importimage { 

public static void main(String[] args) { 

String dir = args[0]; 

String isbn = args[l]; 

InputStream fin = null; 

Connection con = null; 
try { 

FilelnputStream in = new FilelnputStream ( 
"dbconnect .properties" ) ; 

Properties prop = new Properties () ; 
prop.load(in) ; 
in.closeO ; 

String driver = prop.getProperty ("driver") ; 
String url = prop.getProperty ("url") ; 



Große Binärobjekte 
schreiben und lesen 



Programm 2.10 



Importimage 
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Programm 2.11 



Exportimage 



String user = prop . getProperty ( "user " ) ; 

String password = prop. getProperty ("password") ; 

Class . forName (driver) ; 

con = DriverManager.getConnection (url, user, password); 

String image = dir + "/" + isbn + ".jpeg"; 

File file = new File (Image) ; 
int length = (int) f ile . length ( ) ; 
fin = new FilelnputStream(file) ; 

PreparedStatennent ps = con.prepareStatement ( 

"update buch set bild = ? where isbn = ?"); 

ps.setBinaryStream(l, fin, length); 
ps . setString (2, isbn) ; 

int count = ps.executeUpdate () ; 
if (count > 0) 

System.out.println( image + " wurde importiert"); 
ps . close ( ) ; 

} 

catch (Exception e) { 

System. err .printin (e) ; 

} 

finally { 
try { 

if (con != null) 
con. close () ; 
if (fin != null) 
fin. close () ; 

} 

catch (Exception e) { 

System. err. printin (e) ; 



} 



Mit Programm 2.11 kann ein solches gespeichertes jpeg-Bild 
wieder in ein Dateiverzeichnis exportiert werden. 



import java.sql.*; 
import java.io.*; 
import java.util.*; 

public class Exportimage { 

public static void main (String [ ] args) { 
String dir = args[0]; 

String isbn = args[l]; 

InputStream fin = null; 
FileOutputStream fout = null; 
Connection con = null; 
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try { 

FilelnputStream in = new FilelnputStream ( 

"dbconnect .properties" ) ; 

Properties prop = new Properties () ; 
prop.load(in) ; 
in.closeO ; 

String driver = prop.getProperty ("driver") ; 

String url = prop.getProperty ("url") ; 

String user = prop.getProperty ("user") ; 

String password = prop.getProperty ("password") ; 

Class . forName (driver) ; 

con = DriverManager.getConnection(url, user, password); 

Statement stmt = con.createStatement () ; 

ResultSet rs = strnt . executeQuery ( 

"select bild from buch where isbn = + isbn + 

and bild is not null"); 

if (rs.nextO) ( 

fin = rs .getBinaryStream(l) ; 

String image = dir + "/" + isbn + ".jpeg"; 
fout = new FileOutputStream (image) ; 
byte[] buffer = new byte[1024]; 
int size; 

while ((size = f in . read (buff er ) ) != -1) { 
fout .write (buffer, 0, size); 

} 

fout . f lush ( ) ; 

System.out.println("Bild wurde exportiert: " + image); 

) 

eise 

System.out.println("Kein Bild vorhanden"); 

rs.closeO ; 
stmt . close ( ) ; 

) 

catch (Exception e) { 

System. out .printin (e) ; 

> 

finally ( 
try { 

if (con != null) 
con . close ( ) ; 
if (fin != null) 
fin . close ( ) ; 
if (fout != null) 
f out. close () ; 

) 

catch (Exception e) { 

System. err .printin (e) ; 
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Navigierbarkeit 



Änderbarkeit 



2.7 Navigation und Änderungen in der Ergebnis- 
menge 

Bei der Erzeugung von SELECT-An Weisungen kann auf die Art 
der Verwendung der Ergebnismenge Einfluss genommen wer- 
den. Hierzu existieren die beiden Connection-Methoden 

Statement createStatarent (int resultSetType, int resultSetConcurrency) 
throws SQLException 

PreparedStatement prepareStatesnent (String sql, int resultSetType, 
int resultSetConcurrency) throws SQLException 

Der Parameter resultSetType bestimmt, wie in der Ergebnismenge 
mit Hilfe eines internen Cursors navigiert werden kann. Der 
Parameter resultSetConcurrency legt fest, ob Datensätze der Ergeb- 
nismenge direkt geändert werden können. 



Für resultSetType können folgende Konstanten verwendet wer- 
den: 

ResultSet . TYPE_FORWARD_ONLY 

Der Cursor kann nur zum nächsten Satz bewegt werden. 

ResultSet . TYPE_SCROLL_INSENSITIVE 

Der Cursor kann frei bewegt werden. 

ResultSet . TYPE_SCROLL_SENSITIVE 

Der Cursor kann frei bewegt werden. Änderungen durch andere 
Transaktionen sind sichtbar. 



Für resultSetConcurrency können folgende Konstanten verwendet 
werden: 

ResultSet . CONCUR_READ_ONLY 

Änderungen können nicht vorgenommen werden. 

ResultSet . CONCURJSPDATABLE 

Datensätze können in der Ergebnismenge geändert werden. 



Die freie Navigation kann bei entsprechender Einstellung mit 
den folgenden ResuitSet-Methoden erfolgen: 

boolean next ( ) 
boolean previous ( ) 
boolean first () 
boolean last ( ) 
boolean absolute (int row) 
boolean relative (int rows) 
void beforeFirst ( ) 
void beforeLast ( ) 

Der Cursor wird zur nächsten, vorherigen, ersten, letzten Zeile 
bewegt, auf die Zeile mit der Nummer row positioniert (die Zäh- 
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lung beginnt bei 1), um rows Zeilen vorwärts bzw. rückwärts (bei 
negativer Zahl) bewegt, vor die erste Zeile, hinter die letzte Zeile 
bewegt. 

Ferner existieren die Prüfmethoden: 

boolean isFirst ( ) 
boolean isLast ( ) 
boolean isBef oreFirst ( ) 
boolean isAfterLast ( ) 

int getRowO 

liefert die Nummer des aktuellen Datensatzes (1 für den ersten 
Satz). 



Programm 2.12 demonstriert die verschiedenen Möglichkeiten Programm 2.12 
der Navigation durch die Ergebnismenge. 



import java.sql.*; 
import java.io.*; 
import java.util.*; 

public dass Navigation { 

public static void main( String [] args) { 

Connection con = null; 

Statement stmt = null; 

ResultSet rs = null; 
try { 

FilelnputStream in = new FilelnputStream ( 

"dbconnect .properties" ) ; 

Properties prop = new Properties () ; 
prop.load(in) ; 
in.closeO ; 

String driver = prop.getProperty ("driver") ; 

String url = prop.getProperty ("url") ; 

String user = prop.getProperty ("user") ; 

String password = prop.getProperty ("password") ; 

Class . forName (driver) ; 

con = DriverManager.getConnection(url, user, password); 

stmt = con. createStatement (ResultSet. TYPE_SCROLL_INSENSITIVE, 
ResultSet . CONCUR_REÄD_CNLY) ; 
rs = stmt . executeQuery ( 

"select isbn, titel from buch Order by isbn") ; 

if (rs.lastO) { 

System.out.println ("Anzahl Zeilen: " + rs. getRowO ) ; 

) 

eise { 

System.out.println ("Ergebnismenge ist leer") ; 
return; 

} 



rs.bef oreFirst () ; 
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System. out .printin ( 

"Ihre Eingabe bitte: next, previous, first, last oder quit"); 

BufferedReader br = new Buf feredReader ( 
new InputStreamReader (System. in) ) ; 

String line; 

while ((line = br.readLine () ) != null) ( 
try { 

if (line. equals ("next") ) { 
if (rs.nextQ) 

System. out. printin (rs.getRowQ + " " + rs .getString(l) 

+ " " + rs.getString(2) ) ; 

} 

eiseif (line. equals ("previous") ) { 
i f ( r s . previous ( ) ) 

System, out. printin (rs.getRowQ + " " + rs .getString(l) 

+ " " + rs.getString(2) ) ; 

} 

eise if (line. equals ("first") ) { 
if (rs. first ()) 

System, out. printin (rs.getRowQ + " " + rs .getString(l) 

+ " " + rs.getString(2) ) ; 

) 

eise if (line. equals ("last") ) ( 
if (rs.lastQ) 

System, out. printin (rs.getRowQ + " " + rs .getString(l) 

+ " " + rs.getString(2) ) ; 

} 

eise if (line. equals ("quit") ) < 
break; 



catch (SQLException e) { 
System. err. printin (e) ; 



catch (Exception e) { 

System. err .printin (e) ; 

} 

finally { 
try { 

if (rs != null) 
rs . close ( ) ; 
if (stmt != null) 
stmt . close ( ) ; 
if (con != null) 
con. close () ; 

} 

catch (SQLException e) { } 
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Ist die Ergebnismenge als änderbar eingestellt, können Datensät- 
ze direkt in einem Resuitset-Objekt eingefügt, geändert und ge- 
löscht werden. In der Regel darf die SELECT-Abfrage nur eine 
Tabelle umfassen (keine JOINs), keine Aggregat-Funktion, 
GROUP-Klausel und ORDER BY-Klausel enthalten und muss den 
Primärschlüssel mit einschließen. Die genauen Regeln hängen 
vom DBMS ab. 



Für das Folgende setzen wir voraus, dass der Cursor auf einem 
bestimmten Datensatz der Ergebnismenge positioniert ist. 



Aufruf der Resuitset-Methoden 

void updateXxx (int idx, typ x) throws SQLException 

analog zu den setxxx-Methoden aus Kapitel 2.4.3, also z. B. 
rs .updateint (3, 100) ; 

Aufruf der Resuitset-Methode 
void updateRow ( ) throws SQLException 



Aufruf der Resuitset-Methode 

void moveToInsertRowQ throws SQLException 

Aufruf der updateXxx-Methoden. 

Aufruf der Resuitset-Methode 
void insertRow() throws SQLException 

Ggf. Aufruf der Resuitset-Methode 

void moveToCurrentRow ( ) throws SQLException 

um zum aktuellen Datensatz zurückzukehren. 



Aufruf der Resuitset-Methode 
void deleteRow ( ) throws SQLException 



Programm 2.13 demonstriert die drei Änderungsarten. Zu einem 
Buch kann die Bestandszahl geändert werden, ein neues Buch 
mit ISBN-Nummer kann eingefügt werden, ein Datensatz kann 
gelöscht werden. 



import java.sql.*; 
import java.io.*; 
import java.util.*; 

public dass Update { 

public static void main (String [] args) { 
Connection con = null; 

Statement stmt = null; 

ResultSet rs = null; 



Ändern 



Einfügen 



Löschen 



Programm 2.13 
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try { 

FilelnputStream in = new FilelnputStream ( 

"dbconnect .properties") ; 

Properties prop = new Properties () ; 
prop.load(in) ; 
in.closeO ; 

String driver = prop.getProperty ("driver") ; 

String url = prop.getProperty ("url") ; 

String user = prop.getProperty ("user") ; 

String password = prop.getProperty ("password") ; 

Class . forName (driver) ; 

con = DriverManager .getConnection (url, user, password); 

stmt = con . createStatement (ResultSet . TYPE_SCROLL_INSENSITIVE, 
ResultSet . CONCUR_UPDATÄBLE ) ; 
rs = stmt . executeQuery ( 

"select isbn, titel, bestand, stand frombuch"); 
if (rs.lastO) { 

System. out .pr intin ("Anzahl Zeilen: " + rs .getRowf) ) ; 

} 

eise ( 

System. out. printin ( "Ergebnismenge ist leer"); 
retum; 

> 

rs . first ( ) ; 

System. out .printin ( ) ; 

System. out. printin (rs. getRowf) + " " + rs.getString(l) 
t " " + rs.getString(2) + " " + rs.getString(3) ) ; 

System. out .printin ( ) ; 

System. out .printin ("Ihre Eingabe bitte: "); 

System. out .printin ( 

"<Bestand>, insert <ISBN>, delete, nur RETURN oder quit"); 

BufferedReader br = new Buf feredReader ( 
new InputStreamReader (System. in) ) ; 

String line; 

while ((line = br.reactLine () ) != null) ( 
if (line . equals ( "quit" ) ) 
break; 

try { 

if (line. equals ("") ) { 
if (rs.nextQ) 

System. out. printin (rs.getRowQ + " " + rs .getString(l) 
+ " " + rs.getString(2) + " " + rs.getString(3) ) ; 
eise { 

System, out. printin ("ENDE") ; 
break; 



eise if (line. startsWith ("insert ")) { 
String isbn = line. substring (7) ,trim(); 
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rs .moveToInsertRow ( ) ; 
rs . updateString ( 1 , isbn) ; 
rs . insertRow ( ) ; 
rs .moveToCurrentRow ( ) ; 

System. out .printin ("insert OK") ; 

> 

eise if (line.equals ("delete") ) { 
rs.deleteRowQ ; 

System. out .printin ("delete OK") ; 
rs.previous () ; 

> 

eise ( 
try ( 

int bestand = Integer .parseint (line) ; 
rs .updateint (3, bestand) ; 
rs .updateTimestamp (4, new Timestamp( 

System . currentT imeMi 1 lis ( ) ) ) ; 
r s . updateRow ( ) ; 

System.out.println(rs.getRow() + " " + rs.getString(l) 
+ " " + rs.getString(2) + " " + rs.getString(3) ) ; 

) 

catch (NumberFormatException e) { 

System. err .printin ("Keine Integerzahl") ; 



catch (SQLException e) { 
System. err. printin (e) ; 



catch (Exception e) { 

System. err .printin (e) ; 

) 

finally ( 
try ( 

if (rs != null) 
rs . close ( ) ; 
if (strnt != null) 
stmt. close () ; 
if (con != null) 
con . close ( ) ; 

) 

catch (SQLException e) { } 
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XML 



Programm 2.14 



2.8 Exkurs: XML-Dokumente aus SQL-Abfragen er- 
zeugen 

Thema dieses Kapitels ist die Entwicklung eines Programms, das 
das Ergebnis einer beliebigen SQL-Abfrage in eine XML-Struktur 
überführt und diese dann in ein anderes Format (z.B. HTML) 
mittels XSLT (Extensible Stylesheet Language Transformation) 
transformiert. 

Zunächst einige Bemerkungen zu XML: 

Mit so genannten Auszeichnungssprachen (wie z.B. HTML) kön- 
nen beliebigen Textelementen Eigenschaften zugewiesen wer- 
den, wodurch deren Formatierung oder Bedeutung festgelegt 
wird. Die Textelemente werden durch Markierungen (tags) ge- 
kennzeichnet. Auf eine Startmarkierung folgt das Textelement, 
das in der Regel durch eine Endemarkierung abgeschlossen 
wird. Dabei sind die Markierungen im Allgemeinen geschachtelt, 
d.h. im markierten Text können weitere Markierungen enthalten 
sein. Das ermöglicht eine hierarchische Strukturierung des In- 
halts. 

XML (Extensible Markup Language) ermöglicht mit selbst defi- 
nierten Tags eine genaue Beschreibung strukturierter Informatio- 
nen, die dann maschinell ausgewertet werden können. Im Unter- 
schied zur Sprache HTML, deren Tags fest vorgegeben sind, ist 
XML eine Metasprache , mit der anwendungsspezifische Aus- 
zeichnungssprachen definiert werden können. 



Das XML-Dokument param.xml enthält Angaben zur Herstellung 
einer Datenbankverbindung, eine SQL-Abfrage und einige Datei- 
namen. 

Der allgemeine Aufbau dieser Datei sieht wie folgt aus: 

<params> 

<param> 

<param-nanie>Parainetername</parain-name> 

<param-value>Parameterwert</param-value> 

</param> 

</params> 



Das zu entwickelnde Programm 2.14 (db 2 xml) liest diese Parame- 
ter mit Hilfe der Klasse XMLParameters zu Beginn ein. 
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<?xml version="1.0" encoding= " I SO- 8859-1 "?> 

<params> 

<!— MySQL — > 

<param> 

<param-name>driver</param-name> 

<param-value>com.mysql . jdbc .Driver</param-value> 

</param> 

<param> 

<param-name>ur 1 < / param-name> 

<param-value> jdbc :mysql : //localhost/buecher</param-value> 
</param> 

<param> 

<param-name>user</ param-name> 
<param-value>root</param-value> 

</param> 

<param> 

<param-name>pas sword< / param-name> 
<param-value>root</param-value> 

</param> 

<! — SQL-Abfrage — > 

<param> 

<param-name>sql</param-name> 

<param-value> 

select autor, titel, isbn, preis, bestand, stand 
from buch Order by autor, titel 
</param-value> 

</param> 

<! — XML-Ausgabe — > 

<param> 

<param-name>xmlFile</param-name> 

<param-value>result/ result . xml</param-value> 

</param> 

<!— XSLT-Template — > 

<param> 

<param-name>xslFile</param-name> 

<param-value>terrplate . xsl</param-value> 

</param> 

<! — Output — > 

<param> 

<param-naine>outputFile</param-name> 

<param-value>result /result . html</param-value> 

</param> 

</params> 



Die Leistung der Klasse XMLParameters besteht im Parsen des XML- 
Dokuments mit Hilfe eines SAX-Parsers (Simple API for XML) 
und der Bereitstellung der Parameternamen und -werte in Form 
eines Properties-ObjektS. 

Ein SAX-Parser bietet ein ereignisorientiertes API. Der Parser liest 
das XML-Dokument sequentiell durch und ruft spezielle Call- 



param.xml 



74 



2 Datenbankanwendungen mit JDBC 



XMLParameters 



back-Methoden immer dann auf, wenn er im Eingabestrom ein 
Tag oder ein Textelement entdeckt. 



package xmlutils; 

import javax . xml . parsers . ParserConf igurat ionExcept ion; 

iirport javax . xml . parsers . SAXParserFactory; 

inport javax . xml . parsers . SAXParser ; 

inport org.xml.sax.XMLReader; 

inport org . xml . sax . InputSource ; 

inport org . xml . sax . Attributes ; 

inport org . xml . sax . SAXExcept ion ; 

inport org . xml . sax . helpers . Def aultHandler ; 

inport java.io.*; 

inport java.util.*; 

public dass XMLParameters extends DefaultHandler { 
private String element; 
private String name = 
private String value = 

private Properties properties = new Properties ( ) ; 

public XMLParameters (String filename) throws Fi leNotFoundExcept ion , 
IOException, ParserConfigurationException, SAXException { 

SAXParserFactory factory = SAXParserFactory. newlnstance () ; 
SAXParser parser = factory. newSAXParser () ; 

XMLReader reader = parser. getXMLReader () ; 
reader . setContentHandler (this) ; 

reader .parse (new InputSource (new FileReader (filename) ) ) ; 

} 



public void startElement (String namespaceURI , String localName, 
String qName, Attributes attrs) throws SAXException { 
element = qName; 

} 



public void characters (char [] ch, int Start, int length) 

throws SAXException { 

// Textinhalte können sich über mehrere Zeilen erstrecken. 

String text = new String (ch, starb, length) .trim(); 

if (text. length () = 0) 
retum; 

if (element . equals ( "param-name " ) ) { 
if (name. length () > 0) 
name += " "; 
name += text; 

} 

eiseif ( element. equals ("param-value") ) { 
if ( value. length () > 0) 
value += " 
value += text; 
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public void endElement (String namespaceURI, String localName, 
String qName) throws SÄXException { 

if (qName. equals ("param") ) { 
properties . setProperty (name, value) ; 
name = 
value = 




public Properties getParameters ( ) { 
retum properties; 

} 



xMLParameters ist von der Klasse DefauitHandier abgeleitet, die De- 
fault-Implementierungen für alle Callback-Methoden enthält. Die 
Callback-Methoden startElement, endElement und characters werden 
in der Subklasse XMLParameters überschrieben. 

Im Konstruktor von XMLParameters wird ein SAXParserFactory-Objekt 
erzeugt, mit dessen Hilfe dann der eigentliche Parser erzeugt 
wird. Die Methode parse des Interface XMLReader liest das XML- 
Dokument und ruft Callback-Methoden auf. 

Die Callback-Methoden in XMLParameters sind so implementiert, 
dass führende und nachfolgende Leerzeichen beim Parameter- 
namen und -wert ignoriert werden. Insbesondere kann sich der 
Parameterwert über mehrere Zeilen erstrecken. 



Die Methode convert der Klasse xMLConverter erzeugt aus dem 
Ergebnis einer SQL- Abfrage (Resuitset) ein XML-Dokument. der 
Form: 

<result> 

<headers> 

<header>Spaltennamel</header> 

</headers> 

<rows> 

<row> 

<Spaltennamel>Wertl</ Spaltennamel> 

</ row> 

</ rows> 

</result> 

Die kritischen Zeichen &, <, >, ' und " werden durch so genannte 
Entity-Referenzen ersetzt. 




76 



2 Datenbankanwendungen mit JDBC 



XMLConverter 



package xmlutils; 
inport java.sql.*; 

public dass XMConverter { 
private ResultSet rs; 

public XMIConverter (ResultSet rs) < 
this.rs = rs; 

} 



public String convert ( ) throws SQLException ( 

StringBuilder sb = new StringBuilder ( ) ; 

String sep = System. getProperty ("line. Separator") ; 

sb.append("<?xml version=\"1.0\" encoding=\"ISO-8859-l\"?>" 
+ sep) ; 

sb.append("<result>" + sep); 
sb.append("\t<headers>" + sep); 

ResultSetMetaData rsmd = rs . getMetaData ( ) ; 
int n = rsmd.getColumnCount () ; 
for (int i = 1; i <= n; i++) ( 

sb . append ( " \t \t<header> " + rsmd . getColumnLabel ( i ) 

+ "</header>" + sep) ; 

} 



sb. append ("\t</headers>" + sep); 
sb.append("\t<rows>" + sep); 

while (rs.nextQ) { 

sb.append("\t\t<row>" + sep); 
for (int i = 1; i <= n; i++) { 

sb. append ("\t\t\t<" + rsmd. getColumnLabel (i) + ">" + 
replace ( rs . getString ( i ) ) + 

"</" + rsmd. getColumnLabel (i) + ">" + sep); 

} 

sb.append("\t\t</row>" + sep); 

} 



sb. append ("\t</rows>" + sep); 
sb.append("</result>") ; 

retum sb.toString () ; 

} 



private String replace (String value) < 
StringBuilder sb = new StringBuilder ( ) ; 
int n = value . length ( ) ; 
for (int i = 0; i < n; i++) { 
char c = value. charÄt (i) ; 
switch (c) { 

case sb. append ("& ") ; 

break; 

case : sb.appendC'< ") ; 

break; 

case sb. append ("> ") ; 

break; 
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case ' \ : sb.append("&apos; ") ; 

break; 

case ' \ : sb . append ( " Squot ; " ) ; 

break; 

default: sb.append(c) ; 



retum sb . toString ( ) ; 

} 

} 



Die Methode transform der Klasse XMLTransformer wandelt ein XML- 
Dokument in eine andere Struktur (z.B. ein HTML-Dokument) 
mit Hilfe eines Stylesheets um. Die Extensible Stylesheet Langua- 
ge Transformation (XSLT) beschreibt, wie XML-Dokumente in 
andere Formate transformiert werden können. 

In unserem Beispiel wird das Stylesheet template.xsl verwendet. 



<?xml version="1.0" encoding="ISO-8859-l"?> 

<xsl : stylesheet version=" 1.0" 

xmlns :xsl="http: / /www. w3 .org/1999/XSL/Transfom"> 
<xsl:output method="html" encoding= n ISO-8859-l"/> 

<xsl : terrplate mt ch= " result " > 

<html> 

<head> 

<title>SQL-Ergebnis</title> 

</head> 

<body> 

<table border="l" cel lpadding= " 5 " > 

<tr bgcolor=" light Grey"> 

<xsl : apply-templates select="headers/header" /> 
</tr> 

<xsl : apply-templates select=" rows/row" /> 
</table> 

</body> 

</html> 

</xsl : template> 

<xsl:template match="header"> 

<th align="left"> 

<f ont face="Arial"><xsl : value-of select=" . " /></ f ont> 
</th> 

</xsl : template> 

<xsl : terrplate mat ch= " row" > 

<tr> 

<xsl : apply-templates select=" * " /> 

</tr> 

</xsl : template> 



template.xsl 
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<xsl :template match="*"> 

<td> 

<font face="Arial"Xxsl:value-of select=" . "/x/font> 
</td> 

</xsl : template> 

</xsl : stylesheet> 



template - Elemente legen fest, wie die Ausgabe aussehen soll. Ihr 
Inhalt definiert eine Vorlage, die mit den Daten des XML- 
Dokuments gefüllt wird. Das Attribut match des Tags xsi:tenpiate 
gibt an, für welches Element des XML-Dokuments diese Vorlage 
gilt. 



package xmlutils; 

irrport javax . xml . transfom. TransformerFactory; 

inport javax . xml . trans form . stream . StreamSource ; 

irrport javax . xml .transfom. Transformer; 

inport javax . xml . trans form . stream . StreamResult ; 

inport javax . xml . transfom. Transf ormerConf igurationException; 

inport javax . xml . transfom. Transf ormerException; 

inport java.io.*; 

public dass XMLTransformer { 
private Transformier transformier; 

public XMLTransformer (Reader xsllnput) 

throws TransformerConfigurationException { 

Transf omerFactory factory = TransformerFactory. newlnstance () ; 
transf omer = factory.newTransformer (new StreamSource (xsllnput) ) ; 

} 



public String transf om (Reader xmllnput) 
throws Transf ormerException { 

StringWriter out = new StringWriter ( ) ; 
transf omer . transfom (new StreamSource (xmllnput) , 
new StreamResult (out) ) ; 
retum out . toString ( ) ; 




Im Konstruktor von XMLTransformer wird ein TransformerFactory- 
Objekt erzeugt, mit dessen Hilfe dann der eigentliche Transfor- 
mer auf der Basis eines Stylesheets erzeugt wird. Die Methode 
transfom der Klasse Transfomer wandelt das XML-Dokument um. 

Die main-Methode der Klasse db2xml führt die folgenden Schritte 
aus: 

• Einlesen der Parameter aus param.xml mit Hilfe von xml- 



Parameters 
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• Aufbau der Datenbankverbindung 

• Ausführung der SQL-Abfrage 

• Erzeugung des XML-Dokuments mit Hilfe von XMLConverter 

• XSL-Transformation auf Basis des Stylesheets template.xsl mit 
Hilfe von XMLTransformer 

• Ausgabe in result.html 



Bild 2.11: 

Programmablauf 



Tabelle buch 



V ubn 




tMI 


3-1 5-001 308-9 


Dickens, Charles 


Schwere Zeilen 


3-15-001562-6 


Dickens. Chorles 


Große Erwartungen 


3-15-010606*0 


Dickens. Charles 


Der Weihnachtsabend 


3-257-20998-3 


Dickens, Charles 


Nikolos Nickleby 


3-257-21034-5 


Dickens. Chorles 


David Copperfield 


3-257-21 166-X 


Dickens. Charles 


Bleakhaus 



param.xml 

(Z. 'S 

<param> 

<param-name>sql</param-name> 

<param-value> 

select . . . from . . . where . . . 

< /param-value> 

</param> 

Vl ) 



template.xsl 



Converter 



<?xml version="l . 0" encoding="ISO-8859-l"?> 




<?xml version="l . 0" encoding="ISO-8859-l"?> 


<xsl : stylesheet version="l . 0" xralns :xsl=. . . > 




<result> 


<xsl: output method="html" encoding=. . . /> 




<headers> 


<xsl : template match="result "> 










</headers> 


</xsl :template> 




<rows> 


</xsl : stylesheet> 




</row> 






</result> 




Transformer 



result.html 



autor 


titel 


Dickens. Charles 


Bleak House 


Dickens. Charles 


Bleakhaus 


Dickens. Charles 


Das Geheimnis des Edwin Drood 


Dickens. Charles 


David Copperfield 



import java.sql.*; DB2XML 

irrport java.io.*; 
iirport java . util . * ; 
irrport xmlutils.*; 

public dass DB2XML { 

public static void main (String [] args) { 

Properties prop = null; 

Connection con = null; 

PrintWriter xmlOut = null; 

PrintWriter out = null; 




80 



2 Datenbankanwendungen mit JDBC 



try { 

// Parameter einiesen 

XMLParameters params = new XMLParameters ("param.xml") ; 
prop = params. getParameters () ; 

String driver = prop.getProperty ("driver") ; 

String url = prop.getProperty ("url") ; 

String user = prop.getProperty ("user") ; 

String password = prop.getProperty ("password") ; 

// Treiber laden 
Class . f orName (driver) ; 

// Verbindung zur DB hersteilen 

con = DriverManager . get Connection (url, user, password); 

// SQL-Äbfrage ausführen 

Statement stmt = con.createStatement () ; 

String sql = prop.getProperty ("sql") ; 
if (sql = null) 

throw new Exception ( "Parameter \"sql\" fehlt"); 
ResultSet rs = stmt. executeQuery (sql) ; 

// XML-Ausgabe erzeugen 

XMLConverter conv = new XMLConverter (rs) ; 

String xml = conv.convert () ; 

rs.closeO ; 

stmt .close () ; 

String xmlFile = prop.getProperty ("xmlFile") ; 
if (xmlFile != null) { 

xmlOut = new PrintWriter (new FileWriter (xmlFile) ) ; 
xmlOut. print (xml) ; 
xmlOut . f lush ( ) ; 

System . out . print ln ( "XML-Ausgabe : " + xmlFile ) ; 

} 



// XSL-Transformation 

String xslFile = prop.getProperty ("xslFile") ; 
if (xslFile = null) 

throw new Exception ( "Parameter V'xslFileV fehlt"); 
XMLTransformer trans = new XMLTransformer ( 
new FileReader (xslFile) ) ; 

String output = trans. transform (new StringReader (xml) ) ; 

String outputFile = prop.getProperty ("outputFile") ; 
if (outputFile = null) 

throw new Exception ( "Parameter V'outputFileV' fehlt"); 
out = new PrintWriter (new FileWriter (outputFile) ) ; 
out. print (output) ; 
out. f lush () ; 

System. out . printin ( "Ausgabe der XSL-Transformation: " + 
outputFile) ; 
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catch (Exception e) { 
System, err .printin (e) ; 

} 

finally { 
try { 

if (con != null) 
con.close () ; 
if (xmlOut != null) 
xmlOut .close () ; 
if (out != null) 
out .close () ; 

} 

catch (Exception e) { 

Sy stem . err . print ln (e ) ; 




<?xml version="1.0" encoding= n ISO-8859-l"?> 
<result> 

<headers> 

<header>autor</header> 

<header>t itel</header> 
<header>isbn</header> 

<header>prei s</header> 

<header>bestand</header> 

<header>stand</header> 

</headers> 

<rows> 

<row> 

<autor>Dickens, Charles</autor> 
<titel>Bleak House</titel> 
<isbn>3-458-32810-6</isbn> 
<preis>17</preis> 

<bestand>l 6</bestand> 

<stand>200 6-08-20 00:00:00.0</stand> 
</ row> 

</rows> 

</ result> 



XML-Doku ment 
result.xml 



2.9 Exkurs: Stored Procedures 

Stored Procedures (gespeicherte Prozeduren) bestehen aus SQL- 
Anweisungen und zusätzlichen Befehlen zur Deklaration von 
Variablen, zur Bildung von Schleifen, Verzweigungen usw. 

Solche Prozeduren ermöglichen es, einen Teil der Logik vom Vorteile und 
Clientprogramm auf den Datenbankserver zu verlagern, was oft Nachteile 
zu einer Performanceverbesserung führt, da die Prozedur kom- 
plett auf dem Datenbankserver stattfindet und keine Übertragung 
von Zwischenergebnissen zum Client erfolgen muss. Durch die 
Auslagerung zentraler Codeteile auf den Datenbankserver kön- 
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CallableStatement 


nen Coderedundanzen in den Anwendungsprogrammen vermie- 
den werden, was die Anwendungen besser wartbar macht. Bei- 
spielsweise muss bei Änderung des Datenmodells in der Daten- 
bank nur eine Stored Procedure geändert werden, nicht aber der 
Code in allen betroffenen Anwendungsprogrammen. 

Leider ist die Definition von Stored Procedures abhängig vom 
jeweiligen Datenbankmanagementsystem. Fast jedes System nutzt 
eine eigene Syntax und zusätzliche Spracherweiterungen, was 
eine Portierung auf ein anderes System sehr aufwändig machen 
kann. 

In den folgenden Beispielen nutzen wir das DBMS MySQL, das 
ab Version 5.0 Stored Procedures untersützt. 

Das Interface java.sqi.caiiabiestatement, ein Subinterface von java. 
sqi . Preparedstatement, wird zum Aufruf von Stored Procedures 
eingesetzt. 


Programm 2.15 


Im ersten Beispiel nutzen wir die Stored Procedure zeige- 
Buecher, die alle Bücher aus der Tabelle buch (siehe Kapitel 
2.2.1) liefert, deren Erscheinungsjahr größer oder gleich einem 
als Parameter vorgegebenen Jahr ist. 


Prozedur 

zeigeBuecher 


delimiter $$ 

create procedure zeigeBuecher (in j int) 
begin 

select isbn, autor, titel from buch where jahr >= j; 
end $$ 
delimiter ; 

Die Prozedur hat einen mit in gekennzeichneten Eingabeparame- 
ter. Da der Code selbst das Zeichen ; enthält, ist dieses als De- 
limiter-Zeichen zum Abschließen von SQL-Anweisungen nicht 
geeignet und wird deshalb temporär in das Zeichen $$ geändert. 

Die Prozedur kann beispielsweise mit dem Kommandointerpreter 
mysql erstellt werden: 

mysql -u root -p buecher < zeigeBuecher . sql 


ZeigeBuecher 


Die folgende JDBC-Anwendung ruft die Stored Procedure mit 
einem int-Parameter auf. 




import java. sql.*; 
import java. io.*; 
import java.util.*; 

public dass ZeigeBuecher { 

public static void main (String [ ] args) throws Exception { 
int jahr = Integer. parseint (args [0] ) ; 
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FilelnputStream in = new FileInputStream("dbconnect. properties") ; 
Properties prop = new Properties ( ) ; 
prop.load(in) ; 
in . close ( ) ; 

String driver = prop.getProperty ("driver") ; 

String url = prop.getProperty ("url") ; 

String user = prop . getProperty ( "user " ) ; 

String password = prop.getProperty ("password") ; 

Class . forName (driver) ; 

Connection con = DriverManager.getConnection(url, user, password); 
String str = "(call zeigeBuecher (?)}"; 

CallableStatement stmt = con.prepareCall (str) ; 
stmt. setint (1, jahr) ; 

ResultSet rs = stmt . executeQuery ( ) ; 
while (rs . next ( ) ) { 

System. out. printin (rs.getString(l) + " " + rs.getString(2) 

+ " " + rs.getString(3) ) ; 

} 



rs . close ( ) ; 
stmt. close () ; 
con . close ( ) ; 



} 



Die Connection-Methode 

CallableStatement prepareCall (String sgl) throws SQLException 

erzeugt ein Caiiabiestatement-Objekt. Der Aufruf der Prozedur 
wird in Escape-Syntax notiert, wobei die Parameter jeweils durch 
? festgelegt werden. So enthält sqi im obigen Beispiel die Zei- 
chenkette: (call zeigeBuecher (?) }. 

Zur Belegung der IN-Parameter stehen alle setxxx-Methoden des 
Interface Preparedstatement zur Verfügung. 

Mit executeQuery wird die Ausführung der Prozedur gestartet und 
das Ergebnis der Abfrage zurückgeliefert. 



In einer Stored Procedure können Parameter zur Eingabe (in), 
zur Ausgabe (out) oder zur Ein- und Ausgabe (inout) benutzt 
werden. Dies zeigt das folgende Beispiel: 



delimiter $$ 

create procedure updateBestand(in buchnr varchar(13), in menge int, 
out Code int, out alt int, out neu int) 
begin 

declare ent int; 
main: begin 

select count (*) from buch where isbn = buchnr into ent; 



Programm 2.1 6 



Prozedur 

updateBestand 
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UpdateBestand 



if ent = 0 then 
set code = 1; 
leave min; 
end if; 

select bestand from buch where isbn = buchnr into alt; 
set neu = alt + menge; 

update buch set bestand = neu where isbn = buchnr; 
set code = 0; 
end min; 
end $$ 
delimiter ; 



Die Prozedur erhöht bzw. vermindert den Lagerbestand eines 
Buches ( buchnr ) um eine vorgegebene Menge (menge). Ausga- 
beparameter sind code (0 = erfolgreiche Ausführung, 1 = Buch 
wurde nicht gefunden), der Bestand vor der Änderung (alt) und 
der Bestand nach der Änderung (neu). 



import java.sql.*; 
import java.io.*; 
import java.util.*; 

public dass UpdateBestand { 

public static void main (String [ ] args) throws Exception { 

String isbn = args[0]; 

int menge = Integer. parseint (args [1] ) ; 

FilelnputStream in = new FileInputStream("dbconnect. properties") ; 
Properties prop = new Properties ( ) ; 
prop.load(in) ; 
in . close ( ) ; 

String driver = prop . getProperty ( "driver " ) ; 

String url = prop. getProperty ("url") ; 

String user = prop. getProperty ("user") ; 

String password = prop. getProperty ("password") ; 

Class . forName (driver) ; 

Connection con = DriverManager . getConnection (url, user, password); 
String str = "{call UpdateBestand (?,?,?,?,?)}"; 

CallableStatement stmt = con.prepareCall(str) ; 
stmt.setString(l, isbn); 
stmt . setint (2, menge) ; 

stmt . registerOutParameter (3, Types . INTEGER) ; 
stmt . registerOutParameter ( 4 , Types . INTEGER) ; 
stmt . registerOutParameter (5, Types . INTEGER) ; 

stmt .executeUpdate () ; 
int rc = stmt.getlnt (3) ; 
if (rc = 0) { 

int alt = stmt.getlnt (4) ; 
int neu = stmt.getlnt (5) ; 
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System. out .printin ("Bestand alt: " + alt); 
System. out .printin ("Bestand neu: " + neu); 



eise { 

System. out .printin ("Buch nicht vorhanden"); 



stmt.closeO ; 
con . close ( ) ; 



Ausgabeparameter (out) sowie Ein-/Ausgabeparameter (inout) 
müssen registriert werden. Hierzu steht die folgende 
Caiiabiestatement-Methode zur Verfügung: 

void registerOutParameter (int idx, int sqlType) throws SQLException 

idx bestimmt die Position des Parameters (die Zählung beginnt 
bei 1), sqlType bestimmt den JDBC-Typ (siehe Bild 2.8). 

Da die obige Prozedur eine Änderungsanweisung enthält, wird 
executeupdate verwendet. Zum Auslesen der Ausgabeparameter 
werden dem JDBC-Typ entsprechende getxxx-Methoden des In- 
terfaces CallableStatement benutzt. 



1. Das Datenmodell in Kapitel 2.2.1 soll um Kunden, Bestel- 
lungen und Bestellpositionen ergänzt werden: 

Tabelle künde-. 
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kunde_id 



integer 



plz 



ort 



kname 



Strasse 



varchar (30) 
varchar (20) 
varchar (5) 
varchar (20) 



Tabelle bestellung: 

bestell_id sieh 



siehe unten 
integer 
date 
integer 



kunde_id 



datum 



Status 



Tabelle bestellposition-, 

bestell_id 
isbn 



menge 



integer 
varchar (17) 
integer 
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Bild 2.12 

Erweitertes 

Datenmodell 




Die bestell_id in der Tabelle bestellung soll mit Unterstüt- 
zung des DBMS beim INSERT als laufende Nummer verge- 
ben werden. Dazu gibt es bei den verschiedenen Systemen 
unterschiedliche Lösungen. 

Bei Access bewirkt der Datentyp counter für die Spalte be- 
stell_id diesen Mechanismus. 

Bei MySQL kann in der CREATE-TABLE-Anweisung auto_ 
increment genutzt werden: 

bestell_id integer auto_increment 

Für Apache Derby sieht die entsprechende Anweisung so 
aus: 

bestell_id integer generated always as identity 

Nutzen Sie Programm 2.5, um die Tabellen einzurichten und 
fügen Sie einige Kundendaten in die Tabelle künde ein. 

2. Schreiben Sie ein Programm, das für einen Kunden Bestell- 
daten aufnimmt. Das Programm soll mit den Parametern 
kunde_id und datei aufgerufen werden. Die Kundennum- 
mer muss eine gültige ID aus Tabelle künde sein, datei be- 
zeichnet eine Datei, die z.B. folgenden Inhalt hat: 

3 - 15 - 001308-9 5 

3 - 15 - 001562-6 3 

3 - 15 - 010606-0 8 

Pro Zeile ist die ISBN-Nummer des bestellten Buches und 
die gewünschte Stückzahl enthalten. 

Die Spalte Status soll den Wert 0 erhalten. 

Die erzeugte Bestellnummer in der Tabelle bestellung muss 
in der Tabelle bestellposition als Fremdschlüssel eingetragen 
werden. Für die einzelnen Datenbanksysteme gibt es dazu 
unterschiedliche Verfahren: 
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Nach "insert into besteiiung ..." kann die letzte auto- 
matisch generierte Nummer mit der Anweisung "seiect 
@@identity" abgefragt werden. Diese wird dann in die Tabel- 
le bestellposition eingetragen. 

Wird an die statement-Methode executeüpdate als zweiter Pa- 
rameter der Wert statment . ^txipn_geisierated_keys übergeben, so 
liefert die Statement-Methode getGeneratedKeysO ein ResultSet- 
Objekt, das die generierte Nummer enthält. 

3. Bestellte Bücher müssen für die Auslieferung vorbereitet 
werden. Schreiben Sie ein Programm, das für eine vorgege- 
bene bestell_id folgende Aktionen durchführt: 

a) Prüfen, ob die beim Programmaufruf mitgegebene ID als 
bestell_id in der Tabelle besteiiung vorkommt. 

Wenn ja: 

b) Prüfen, ob diese Bestellung noch unbearbeitet (Status = 
0) ist. 

Wenn ja: 

c) Verfügbarkeit prüfen. 

Pro Bestellposition muss geprüft werden, ob die ge- 
wünschte Stückzahl die Bestandszahl aus der Tabelle buch 
nicht übersteigt. Entsprechende Meldungen sind auszu- 
geben. 

Wenn alle bestellten Bücher in der gewünschten Stückzahl 
vorrätig sind: 

d) Lagerbestand in der Tabelle buch für alle Bestell- 
positionen gemäß der bestellten Stückzahl reduzieren und 
den Status in der Tabelle besteiiung auf den Wert I setzen. 

4. Entwickeln Sie ein Programm, das die Bestandsdaten ( isbn , 
bestand, stand) der Tabelle buch der Bücher-Datenbank 
(z.B. verwaltet mit MS Access) in eine Datenbank eines an- 
deren Datenbanksystems (z.B. MySQL ) kopiert. Die hierfür 



Bild 2.13: 

Ergehn isbeispiel 



Access 



MySQL lind 
Apache Derby 
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geeignete Tabelle der Zieldatenbank soll ebenfalls mit die- 
sem Programm erstellt werden. 

5. Erstellen Sie eine Variante von Programm 2.6, die Batch- 
Updates (siehe Kapitel 2.4.2) benutzt. 




3 Verbindungslose Kommunikation mit UDP 



Das User Datagram Protocol (UDP) stellt grundlegende Funkti- 
onen zur Verfügung, um mit geringem Aufwand Daten zwischen 
kommunizierenden Prozessen austauschen zu können. UDP ist 
als Transportprotokoll der dritten Schicht im TCP/IP-Schich- 
tenmodell zugeordnet und nutzt den Vermittlungsdienst IP. 

3.1 Das Protokoll UDP 

UDP ist ein verbindungsloses Protokoll, d.h. es bietet keinerlei 
Kontrolle über die sichere Ankunft versendeter Datenpakete, so 
genannter Datagramme. 

UDP ist im RFC (Request for Comments) 768 der IETF (Internet 
Engineering Task Force) spezifiziert (siehe auch http://www.ietf. 

org/rf c/rf c7 68 . txt) . 

Datagramme müssen nicht den Empfänger in der Reihenfolge Datagramm 
erreichen, in der sie abgeschickt werden. Datagramme können 
verloren gehen, weder Sender noch Empfänger werden über den 
Verlust informiert. Fehlerhafte Datagramme werden nicht noch- 
mals übertragen. 

Bild 3-1 zeigt den Aufbau des UDP -Datagramms, das in ein IPv4- 
Paket eingebettet ist. 







Bild 3-1 
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Der UDP-Kopfteil enthält vier 16 Bit lange Felder: 

• die Portnummer des Senders, 

• die Portnummer des Empfängers, 

• die Gesamtlänge des UDP-Datagramms und 

• die Prüfsumme. 

Darauf folgen dann die eigentlichen Nutzdaten des Datagramms. 

Die Maximallänge eines UDP-Datagramms ist begrenzt. Anwen- 
dungen sollten nicht mehr als 508 Byte Nutzdaten in einem 
Datagramm versenden, um Probleme infolge einer evtl, nötigen 
Fragmentierung des IP-Pakets durch Router zu vermeiden. 



UDP ist ein einfaches Mittel, um Nachrichten, die keine zuverläs- 
sige Übertragung erfordern, zu versenden. UDP hat gegenüber 
TCP den Vorteil eines viel geringeren Kontroll-Overheads (8 Byte 
bei UDP, 20 Byte bei TCP). 

UDP-Anwendungen Einige bekannte Anwendungen, die UDP nutzen, sind: 

• das Domain Name System (DNS) zur automatischen Konver- 
tierung von Domain-Namen (Rechnernamen) in IP-Adressen 
und umgekehrt, 

• das Simple Network Management Protocol (SNMP) zur Verwal- 
tung von Ressourcen in einem TCP/IP-basierten Netz, 

• das Trivial File Transfer Protocol (TFTP), das einen einfachen 
Dateitransferdienst zum Sichern und Laden von System- und 
Konfigurationsdateien bietet, 

• das Dynamic Host Configuration Protocol (DHCP) zur dyna- 
mischen Zuweisung von IP-Adressen. 

Die unidirektionale Übertragung von Video- und Audiose- 
quenzen zur Wiedergabe in Echtzeit ( Multimedia Streaming) ist 
besonders zeitkritisch. Der gelegentliche Verlust eines Datenpa- 
kets kann aber toleriert werden. Hier ist UDP sehr gut geeignet. 



3.2 DatagramSocket und Datag ram Packet 

Java-Programme nutzen so genannte Sockets als Programmier- 
schnittstelle für die Kommunikation über UDP/IP und TCP/IP. 
Sockets stellen die Endpunkte einer Kommunikationsbeziehung 
zwischen Prozessen dar. 

Ein UDP-Socket wird an eine Portnummer auf dem lokalen 
Rechner gebunden. Er kann dann Datagramme an jeden beliebi- 
gen anderen UDP-Socket senden und von jedem beliebigen 
UDP-Socket empfangen. 



3.2 DatagramSocket und DatagramPacket 
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Rechner A Rechner B 



Client 


IP 10.108.105.95 
/ Port 3963 

IP 10.108.105.96 _ 
Port 50000 


Server 


UDP-Socket 


UDP-Socket 









Bild 3-2: 

UDP-Sockets 



Die Klasse java.net. DatagramSocket repräsentiert einen UDP-Socket DatagramSocket 
zum Senden und Empfangen von UDP-Datagrammen. 

Ein UDP-Socket muss an einen Port des lokalen Rechners ge- 
bunden werden. Hierzu stehen Konstruktoren zur Verfügung: 

DatagramSocket ( ) throws SocketException 

erzeugt einen UDP-Socket und bindet ihn an einen verfügbaren 
Port des lokalen Rechners. 

DatagramSocket (int port) throws SocketException 

erzeugt einen UDP-Socket und bindet ihn an die Portnummer 
port des lokalen Rechners. Hierdurch kann ein Server den Port, 
den er nutzen möchte, festlegen. 

Beide Konstruktoren können bei Fehlern im zugrunde liegenden 
Protokoll die Ausnahme java.net. SocketException auslösen: 

SocketException ist Subklasse von java.io.IOException. 



Die beiden Methoden 

InetAddress getLocalAddress ( ) und 
int getLocalPort ( ) 

liefern die IP-Adresse bzw. die Portnummer, an die der UDP- 
Socket gebunden ist. 

void close() 

schließt den UDP-Socket. 



Die Klasse java.net. DatagramPacket repräsentiert ein UDP-Data- DatagramPacket 
gramm. 

Der Konstruktor 

DatagramPacket (byte [] buf, int length, InetAddress address, int port) 

erzeugt ein UDP-Datagramm zum Senden von Daten, buf enthält 
die Daten, address ist die IP-Adresse und port die Portnummer 
des Empfängers. Die Anzahl length der zu übertragenden Bytes 
muss kleiner oder gleich der Pufferlänge sein. 
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Der Konstruktor 

DatagrarriPacket (byte [ ] buf , int length) 



send 



receive 



Bild 33: 

Datagramm senden 



erzeugt ein UDP-Datagramm zum Empfangen von Daten, buf ist 
der Puffer, der die empfangenen Daten aufnimmt, length legt fest, 
wie viele Bytes maximal gelesen werden sollen, length muss 
kleiner oder gleich der Pufferlänge sein. Wendet man auf dieses 
Paket die Methoden setAdress und setPort (siehe weiter unten) an, 
so kann es auch gesendet werden. 



Die DatagraraSocket-Methode 

void send (DatagrarriPacket p) throws IOException 

sendet ein UDP-Datagramm von diesem Socket aus. 

Die DatagraraSocket-Methode 

void receive (DatagrarriPacket p) throws IOException 

empfängt ein UDP-Datagramm von diesem Socket, p enthält die 
Daten sowie die IP-Adresse und die Portnummer des Senders. 
Die Methode blockiert so lange, bis ein Datagramm empfangen 
wurde. 

Bild 3-3 zeigt den Ablauf zum Senden eines Datagramms in Form 
eines UML-Sequenzdiagramms. 




3.2 DatagramSocket und DatagramPacket 
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Weitere DatagramPacket-Methoden sind: 
byte [ ] getData ( ) 

liefert den Datenpufferinhalt. 

int getLengthO 

liefert die Länge der Daten, die empfangen wurden bzw. gesen- 
det werden sollen. 

InetAddress getAddress ( ) 

liefert die (entfernte) IP-Adresse des Senders (beim empfangenen 
Datagramm) bzw. des Empfängers (beim zu sendenden Data- 
gramm). 

int getPortO 

liefert die (entfernte) Portnummer des Senders (beim empfange- 
nen Datagramm) bzw. des Empfängers (beim zu sendenden 
Datagramm). 

void setData (byte [ ] buf) 

setzt den Datenpuffer des Datagramms. 

void setLength(int length) 

bestimmt die Anzahl Bytes, die gesendet werden sollen bzw. die 
maximale Anzahl Bytes, die empfangen werden sollen, length 
muss kleiner oder gleich der Pufferlänge des Datagramms sein. 

void setArfdress ( InetAddress address) 

setzt die IP-Adresse des Rechners, an den das Datagramm ge- 
sendet werden soll. 

void setPort (int port) 

setzt die Portnummer, an die das Datagramm gesendet werden 
soll. 



In allen Beispielen dieses Kapitels ist die Bearbeitungszeit des 
Servers nach Eintreffen eines Pakets relativ kurz. Deshalb ist eine 
iterative Implementierung (Paket empfangen - Anfrage bearbei- 
ten - Paket senden) ausreichend. 

Bei längeren Bearbeitungszeiten sollten für die Bearbeitung und 
das Senden der Antwort zu einer Anfrage Threads benutzt wer- 
den ( parallele Implementierung ), um die durchschnittliche War- 
tezeit eines Clients zu reduzieren. 



Weitere Datagram- 
Packet-Methoden 
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Programm 3-1 



Bild 3 A: 

Echo-Dienst 



EchoServer 



3.3 Ein Echo-Server und -Client 

Das erste Programmbeispiel ist eine einfache Client-Server- 
Anwendung, die den Umgang mit den Methoden des vorigen 
Abschnitts zeigen soll. 



Der Client schickt einen Text, den der Server als Echo an den 
Absender zurückschickt. 



“Hallo“ 


From: 3963 


From: 10.108.105.95 




To: 50000 


To: 10.108.105.96 






IP: 10.108.105.95 IP: 10.108.105.96 

Port: 3963 Port: 50000 





“Hallo“ 


From: 50000 


From: 10.108.105.96 




To: 3963 


To: 10.108.105.95 



import java.net.*; 

public dass EchoServer { 

private static final int BUFSIZE = 508; 

public static void min (String [ ] args) throws Exception { 
int port = Integer. parseint (args[ 0] ) ; 

// Socket an Port binden 

DatagramSocket socket = new DatagramSocket (port) ; 

// Pakete zum Empfangen bzw. Senden 
DatagramPacket packet In = new DatagramPacket ( 
new byte [BUFSIZE] , BUFSIZE) ; 

DatagramPacket packetOut = new DatagramPacket ( 
new byte [BUFSIZE] , BUFSIZE) ; 

while (true) { 

// Paket empfangen 
socket . receive (packet In) ; 

Sy stem . out . print ("."); 

// Daten und Länge im Antwortpaket speichern 
packetOut . setData (packetln . getData ( ) ) ; 
packetOut . setLength (packetln . getLength ( ) ) ; 



3.3 Ein Echo-Server und -Client 



95 



// Zieladresse und Zielport im Antwortpaket setzen 
packetOut . setAddress (packetln . getAddress () ) ; 
packetOut . setPort (packetln . getPort ( ) ) ; 

// Antwortpaket senden 
socket . send (packetOut) ; 



} 



Echoserver wird mit dem Parameter Portnummer aufgerufen. 

Zu Beginn wird ein UDP-Socket erzeugt und an die vorgegebene 
Portnummer gebunden. Es werden zwei Datagramme zum Emp- 
fangen bzw. Senden von Daten mit der Pufferlänge 508 Byte 
erzeugt. In einer Endlos-Schleife werden Daten empfangen und 
gesendet. Nutzdaten und Datenlänge sowie IP-Adresse und Port- 
nummer werden aus dem empfangenen Paket gelesen und in 
das zu sendende Paket übertragen. 

Der Server kann über Tastatur mit strg+c abgebrochen werden. 



Das Programm Echoclient sendet ein Datagramm an den Server. 
Neben dem Hostnamen und der Portnummer des Servers wer- 
den die Nutzdaten des Datagramms als weiterer Parameter beim 
Aufruf mitgegeben. 

Erhält der Client nicht innerhalb von zwei Sekunden eine Ant- 
wort vom Server, wird eine Ausnahme ausgelöst und das Pro- 
gramm beendet. 

Diese Zeitsteuerung wird durch Aufruf der folgenden Datagram- 
socket-Methode erreicht: 

void setSoTimeout (int timeout) throws SocketException 
setzt ein Timeout in Millisekunden, receive für diesen Socket 
blockiert höchstens tineout Millisekunden und löst dann die Aus- 
nahme java.net.SocketTimeoutException aus. Wird tineout = 0 gesetzt, 
so wird die Timeout-Steuerung deaktiviert. socketTineoutException 
ist Subklasse von java.io.InterruptedlOException. 

int getSoTimeout ( ) throws SocketException 

liefert die Timeout-Angabe. 



import java.net.*; 

public dass EchoClient { 

private static final int BUFSIZE = 508; 
private static final int TIMEOUT = 2000; 

public static void main( String [] args) throws Exception { 
try { 

String host = args[0]; 

int port = Integer. parseint (args [1] ) ; 



EchoClient 
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byte[] data = args[2] .getBytes () ; 

// Socket wird an anonymen Port gebunden 
DatagramSocket socket = new DatagramSocket ( ) ; 

// Maximal TIMEOUT Millisekunden auf Antwort warten 
socket . setSoTimeout (TIMEOUT) ; 

// Paket an Server senden 

InetAddress addr = InetAddress . getByName (host) ; 
DatagramPacket packetOut = new DatagramPacket ( 
data, data.length, addr, port); 
socket . send (packetOut) ; 

// Antwortpaket empfangen 

DatagramPacket packetln = new DatagramPacket ( 
new byte [BUFSIZE] , BUFSIZE) ; 
socket . receive (packetln) ; 

String received = new String ( 

packetln . getData () , 0, packetln.getLengthO ) ; 
System. out .printin (received) ; 

socket . close ( ) ; 

} 

catch (SocketTimeoutException e) { 

System. err .printin ("Timeout: " + e . getMessage ( ) ) ; 

} 




3.4 Einschränkung der Verbindungen 

Die Klasse DatagramSocket enthält eine Methode, die es ermöglicht, 
die Adresse, an die Datagramme gesendet werden bzw. von der 
Datagramme empfangen werden, gezielt auszuwählen und alle 
anderen Datagramme zu verwerfen: 

void connect ( InetAddress address, int port) 

Datagramme können nur an diese IP-Adresse/Portnummer ge- 
sendet bzw. von dieser IP-Adresse/Portnummer empfangen wer- 
den. 

void disconnect ( ) 

hebt die durch connect hergestellte Restriktion auf. 



Mit den beiden Datagramsocket-Methoden 

InetAddress get InetAddress ( ) und 
int getPortO 

können die IP-Adresse bzw. die Portnummer, die in connect ver- 
wendet wurden, abgefragt werden. Wurde connect nicht benutzt, 
wird null bzw. -l geliefert. 



3.4 Einschränkung der Verbindungen 
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Der Client Sender schickt kurze Texte, die über Tastatur in einer 
Eingabeschleife erfasst werden, als Datagramme an den Server. 
Der Server Receiver zeigt die empfangenen Daten auf dem Bild- 
schirm an. Er soll nur Datagramme, die von einer bestimmten IP- 
Adresse und Portnummer aus gesendet wurden, empfangen 
können. Zu diesem Zweck wird der Server mit drei Parametern 
aufgerufen: lokale Portnummer, IP-Adresse/Rechnername des 
Client und Portnum mer des Client. 



import java.net.*; 

public dass Receiver ( 

private static final int BUFSIZE = 508; 

public static void main (String [] args) throws Exception { 
int port = Integer .parseint (args [0] ) ; 

String remoteHost = args[l]; 

int remotePort = Integer .parseint (args [2] ) ; 

DatagramSocket socket = new DatagramSocket (port) ; 

// Es werden nur Datagranme dieser Adresse entgegengenarmen 
socket .connect (InetAddress.getByNanne (remoteHost) , remotePort) ; 

DatagramPacket packet = new DatagrarriPacket ( 
new byte [BUFSIZE] , BUFSIZE) ; 

while (true) { 

socket . receive (packet) ; 

String text = new String ( 

packet . getData ( ) , 0 , packet . getLength ( ) ) ; 

System, out. printin (packet . getAddressO .getHostAddress () + + 

packet . getPort ( ) ) ; 

System, out .printin (text) ; 

System, out .printin ( ) ; 



} 



Beim Client Sender wird der UDP-Socket an eine explizit vorge- 
gebene Portnummer gebunden, die beim Aufruf des Programms 
als Parameter mitgegeben wird. 



import java.io.*; 
import java.net.*; 

public dass Sender { 

private static final int BUFSIZE = 508; 

public static void main (String [] args) throws Exception { 
int localPort = Integer. parseint (args [0] ) ; 



Programm 3-2 



Receiver 



Sender 
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Aufrufbeispiel 



String host = args[l]; 

int port = Integer . parseint (args [2] ) ; 

// Socket wird an vorgegebenen Port gebunden 
DatagramSocket socket = new DatagramSocket (localPort) ; 

InetMdress addr = InetAddress .getByName (host) ; 
DatagramPacket packet = new DatagramPacket ( 
new byte [BUFSIZE] , BUFSIZE, addr, port); 

BufferedReader in = new Buf feredReader ( 
new InputStreamReader (System. in) ) ; 

while (true) { 

String text = in . readLine ( ) ; 
if (text.equals (".") ) 
break; 

byte [ ] data = text . getBytes ( ) ; 
packet . setData (data) ; 
packet . setLength (data . length) ; 
socket . send (packet) ; 



in . close ( ) ; 
socket. closeO ; 




Aufruf des Serverprogramms: 

Start java -cp build Receiver 50000 localhost 40000 

Es können nur Datagramme von localhost mit Portnummer 40000 
empfangen werden. 



Aufruf des Clientprogramms auf demselben Rechner: 

java -cp build Sender 40000 localhost 50000 

Der Socket des Clients ist an die Portnummer 40000 gebunden. 
Wird hier beim Aufruf statt 40000 z. B. 30000 angegeben, so igno- 
riert der Server die vom Client gesendeten Datagramme. 



3.5 Online-Unterhaltung 
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3.5 Online-Unterhaltung 

Mit dem folgenden Programm Talk können zwei Benutzer an 
verschiedenen Rechnern eine Unterhaltung online führen. 




Benutzer 1 sitzt am Rechner A (IP-Adresse 10.108.105.95), Benut- 
zer 2 am Rechner B (IP-Adresse 10.108.105.96). 



Benutzer 1 ruft das Programm wie folgt auf: 
java -cp build Talk 50000 10.108.105.96 50000 

Benutzer 2 gibt das Folgende ein: 

java -cp build Talk 50000 10.108.105.95 50000 

Der UDP-Socket wird hier jeweils an die explizit vorgegebene 
lokale Portnummer 50000 (erster Parameter) gebunden. 

Zum Test kann das Programm auch zweimal auf demselben 
Rechner (locaihost) gestartet werden. Allerdings müssen dann die 
Portnummern unterschiedlich sein: 

java -cp build Talk 40000 locaihost 50000 
java -cp build Talk 50000 locaihost 40000 



Bild 35 

Online- 

Unterhaltung 



Szenario 
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Programm 33 



import java.awt.*; 
import java.awt.event.*; 
import javax. swing.*; 
import java.net.*; 
import java.io.*; 

public dass Talk implements ActionListener, Runnable ( 
private static final int BUFSIZE = 508; 
private DatagramSocket socket; 
private DatagramPacket packetOut; 
private JTextField input; 
private JTextArea output; 

public static void main (String [ ] args) { 
if (args.length != 3) { 

System. err .printin ( 

"java Talk <localPort> <remoteHost> <remotePort>") ; 
System. exit (1) ; 

} 



JFrame frame = new JFrame (); 
try { 

new Talk (args, frame); 

} 

catch (Exception e) { 

System. err .printin (e) ; 
System. exit (1) ; 

} 



frame. pack() ; 

frame . setvisible (true) ; 



public Talk (String [ ] args, JFrame frame) throws Exception ( 

int localPort = Integer .parseint (args [0] ) ; 

String remoteHost = args[l]; 

int remotePort = Integer .parseint (args [2] ) ; 

InetAddress remoteAddr = InetAddress .getByName (remoteHost) ; 

frame . setTitle ( "Talk - " + 

InetAddress.getLocalHost () .getHost Address () 

+ " : " + localPort + " — > " + 

remoteAddr .getHostAddress () + + remotePort); 

socket = new DatagramSocket (localPort) ; 

packetOut = new DatagramPacket ( 

new byte [BUFSIZE] , BUFSIZE, remoteAddr, remotePort); 

frame . addWindowListener (new WindowAdapter ( ) { 
public void windowClosing (WindowEvent e) { 
if (socket != null) 
socket. close () ; 

System. exit (0) ; 



}); 



3.5 Online-Unterhaltung 
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Container c = f rame . getContentPane () ; 

JPanel panel = new JPanel(new FlowLayout (FlowLayout . LEFT, 2, 2)); 
input = new JTextField(40) ; 

input . setFont (new Font ("Monospaced", Font.PLAIN, 18)); 
panel . add ( input ) ; 

JButton send = new JButton ("Senden") ; 
send.addActionListener (this) ; 
panel . add (send) ; 

c. add (panel, BorderLayout .NORTH) ; 
output = new JTextArea (10, 45) ; 

output . setFont (new Font ( "Monospaced" , Font.PLÄIN, 18)); 
output . setLineWrap (true) ; 
output . setWrapStyleWord (true) ; 
output . setEditable (false) ; 

c.add(new JScrollPane (output) , BorderLayout . CENTER) ; 

// Thread zum Empfangen von Nachrichten starten 
Ihread t = new Thread (this) ; 
t. Start () ; 



public void run() { 

DatagramPacket packetln = new DatagramPacket ( 
new byte [BUFSIZE] , BUFSIZE) ; 

while (true) { 
try ( 

receive (packetln) ; 

) 

catch (IOException e) { 
break; 

> 

) 

} 



private void receive (DatagramPacket packetln) throws IOException { 
socket . receive (packetln) ; 
final String text = new String ( 
packetln.getData () , 0, packetln.getLength () ) ; 

try { 

EventQueue . invokeLater (new RunnableO { 
public void run() { 
output . append (text) ; 
output . append ( " \n" ) ; 

} 

>); 

) 

catch (Exception e) { } 



public void actionPerformed (ActionEvent e) { 
try { 

byte[] data = input . getText ( ) .getBytesO; 
packetOut . setData (data) ; 
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packetOut . setLength (data . length) ; 
socket . send (packetOut) ; 

} 

catch (IOException ex) { 

System. err. printin (ex) ; 




Im Konstruktor werden zunächst IP-Adressen bestimmt, der 
UDP-Socket an die vorgegebene lokale Portnummer gebunden 
und ein Paket zum Senden der eingegebenen Daten erstellt. 
Beim Schließen des Fensters wird der Socket geschlossen. Text- 
feld, Button und Textfläche werden erzeugt und platziert sowie 
das aktuelle Objekt als ActionListener beim Button registriert. 
Schließlich wird ein Thread, der Datagramme empfängt (siehe 
run-Methode), erzeugt und gestartet. 

Innerhalb der run-Methode werden in einer Endlos-Schleife die 
Daten empfangen und in der Textfläche angezeigt. Die Datagram- 
socket-Methode receive blockiert so lange, bis ein Datagramm 
empfangen wurde. Die Ausgabe des Textes erfolgt in der run- 
Methode eines Runnable-Objekts r, das mittels EventQueue. 
invokeLater (r) an den Ereignis-Dispatcher, der für die Aktualisie- 
rung der Benutzungsoberfläche verantwortlich ist, zur Ausfüh- 
rung weitergeleitet wird. 

Beim Drücken des Buttons "Senden" werden die Daten des Ein- 
gabefeldes in einem Datagramm an die Zieladresse gesendet. 



3.6 Aufgaben 

1. Entwickeln Sie einen Server (DaytimeServer), der als Reaktion 
auf den Empfang eines "leeren" Datagramms die aktuelle 
Systemzeit in Form einer Zeichenkette an den Sender zu- 
rückschickt. 

Programmieren Sie für den Test auch einen passenden 
Client (Daytimeciient), der maximal zwei Sekunden auf die 
Antwort des Servers wartet. 

2. Ein Client (ivfesswertciient) sendet in Abständen von 5 Se- 
kunden Zufallszahlen mit Zeitpunktangaben an den Server. 

Der Server (Messwertserver) gibt diese Zahlen zusammen mit 
der IP-Adresse des Senders am Bildschirm aus. 



3.6 Aufgaben 
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Beispiel: 

10.108.105.95:3975 10:45:46 48.72014957156734 
10.108.105.95:3975 10:45:51 48.557565388620226 
10.108.105.95:3975 10:45:56 70.66274469656827 

3. Ein Server (Quoteserver) liefert zufallsgesteuert Zitate. Alle 
Zitate befinden sich in einer Datei quotes.txt, die den fol- 
genden Aufbau hat: 

Zitat feine Zeile) 

Autor des Zitats (eine Zeile) 

Zitat (eine Zeile) 

Autor des Zitats (eine Zeile) 

Erhält der Server ein "leeres" Datagramm, so bestimmt eine 
Zufallszahl, welches Zitat (mit Autor) als Nächstes an den 
Client gesendet wird. 

Programmieren Sie zum einen eine Anwendung mit grafi- 
scher Oberfläche (QuoteApp) und zum andern ein Applet 
(QuoteAppiet) zur Anzeige des angeforderten Zitats. 




4 Client/Server-Anwendungen mit TCP 



Das wichtigste Protokoll der Transportschicht im TCP/IP-Schich- 
tenmodell ist das Transmission Control Protocol (TCP). Es ist 
aufwändiger als UDP, stellt aber dafür eine verlässliche Verbin- 
dung zwischen Client und Server her. Viele bekannte Internet- 
Dienste wie FTP (File Transfer Protocol), Telnet, SMTP 
(Simple Mail Transfer Protocol), POP (Post Office Protocol) und 
FITTP (Hypertext Transfer Protocol) nutzen TCP. 

4.1 Das Protokoll TCP 

TCP ist im Gegensatz zu UDP ein verbindungsorientiertes Proto- 
koll. Zwischen zwei Prozessen (Client und Server) wird eine 
virtuelle Verbindung hergestellt, über die in Form eines bidirek- 
tionalen Datenstroms Bytefolgen beliebiger Länge geschickt wer- 
den können. 

Vor der Übertragung von Daten muss der Client eine Verbindung 
zum Server anfordern. Wird die Verbindung nicht mehr ge- 
braucht, fordert einer der beteiligten Prozesse TCP auf, sie abzu- 
bauen. 




Client 



^ Anfrage >- ( 


0 




^ A Antwort 


0 



Bidirektionale TCP-Verbindung Server 




Bild 4.1 

TCP- Verbindung 



TCP sorgt für die Aufteilung der Daten in einzelne Pakete, garan- 
tiert, dass die Pakete den Empfänger in der richtigen Reihenfolge 
erreichen, und initiiert die Neuübertragung von verloren gegan- 
genen oder defekten Paketen. 

TCP ist im RFC 793 der IETF spezifiziert (siehe auch http://www. 

ietf . org/rfc/rf c793 . txt) . 

Bild 4.2 zeigt den Aufbau eines TCP-Pakets, das Bestandteil der 
Nutzdaten des IPv4-Pakets ist. 

Der TCP-Kopfteil enthält: 

• die Portnummer des Senders (2 Byte), 

• die Portnummer des Empfängers (2 Byte), 
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• weitere Felder mit einer Gesamtlänge von 16 Byte wie z.B. 
Reihenfolgenummer und Prüfsumme, 

• optionale Felder variabler Länge. 

Darauf folgen dann die eigentlichen Nutzdaten des TCP -Pakets. 



Bild 4.2: 

Aufbau des TCP- 
Pakets 
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4.2 TCP-Sockets 

Client-Socket und Im Gegensatz zu UDP wird bei TCP zwischen Client-Socket und 
Server-Socket Server-Socket unterschieden. 

Der Server-Socket versetzt den Server in die Lage, die Verbin- 
dungsanforderungen der Clients abzuhören und dann mehrere 
Clients zu bedienen. 

Bevor Daten zwischen Client und Server ausgetauscht werden 
können, muss eine Verbindung zwischen Sockets hergestellt 
werden. Der Aufruf cler Methode accept des Server-Sockets blo- 
ckiert den Server so lange, bis ein Client versucht, Kontakt auf- 
zunehmen. accept liefert als Ergebnis einen weiteren Socket, über 
den dann die eigentliche Kommunikation stattfindet. 

Die Kontaktaufnahme auf der Client-Seite geschieht automatisch 
bei der Erzeugung des Client-Sockets mit einem geeigneten Kon- 
struktor. Eine Verbindung kann natürlich nur hergestellt werden, 
wenn der Server zeitlich vor dem Start des Client accept aufgeru- 
fen hat. Über Ein- und Ausgabeströme können nun Daten emp- 
fangen bzw. gesendet werden. 



4.2 TCP-Sockets 
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Die Verbindung wird abgebaut, wenn einer der beiden Sockets 
geschlossen wird. 



Die Klasse java.net. socket implementiert einen Client-Socket. 

Socket ( InetAddress address, int port) throws IOException 

erzeugt einen Client-Socket und bindet ihn an die vorgegebene 
IP-Adresse und Portnummer. 

Socket (String host, int port) throws java.net.UnknownHostException, 
IOException 

erzeugt einen Client-Socket und bindet ihn an den vorgegebenen 
Rechner und an die vorgegebene Portnummer. 

void close () throws IOException 

schließt den Socket. 

boolean isClosedO 

liefert true, falls der Socket geschlossen ist, sonst faise. 

void setSoTimeout (int timeout) throws SocketException 

setzt ein Timeout in Millisekunden, read für den Eingabestrom 
dieses Sockets blockiert höchstens timeout Millisekunden und 
löst dann die Ausnahme java.net.socketTimeoutException aus. Wird 
timeout = o gesetzt, so wird die Timeout-Steuemng deaktiviert. 

int getSoTimeout ( ) throws SocketException 

liefert die Timeout-Angabe. 



InputStream getlnputStream ( ) throws IOException 

liefert einen Eingabestrom für diesen Socket. 

OutputStream getOutputStream ( ) throws IOException 

liefert einen Ausgabestrom für diesen Socket. 

Wird einer der beiden Datenströme mit der entsprechenden 
close-Methode geschlossen, so wird auch der zugehörige Socket 
geschlossen. 

Mit einer der folgenden Methoden kann jeweils nur einer der 
beiden Datenströme (Eingabe bzw. Ausgabe) geschlossen wer- 
den, ohne damit den Socket selbst zu schließen: 

void shutdownlnput ( ) throws IOException 

setzt den Eingabestrom für diesen Socket auf EOF (End Of File). 

void shutdownOutput ( ) throws IOException 

deaktiviert den Ausgabestrom für diesen Socket. 



Die Klasse java.net. serversocket implementiert einen Server- 
Socket. 

ServerSocket (int port) throws IOException 

erzeugt einen Server-Socket und bindet ihn an die vorgegebene 
Portnummer. 



Socket 



Input / Output 



ServerSocket 
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backlog 



Ablauf sch ritte 



void close() throws IOException 

schließt den Server-Socket. 

boolean isClosedO 

liefert true, falls der Server-Socket geschlossen ist, sonst faise. 

Socket accept () throws IOException 

nimmt einen Verbindungswunsch an und erzeugt einen neuen 
Socket für diese Verbindung, accept blockiert so lange, bis eine 
neue Verbindung aufgenommen wurde. 

void setSoTimeout (int timeout) throws SocketException 

setzt ein Timeout in Millisekunden, accept blockiert höchstens 
timeout Millisekunden und löst dann die Ausnahme java.net. 
SocketTimeoutException aus. Wird timeout = 0 gesetzt, so wird die 
Timeont-Steiierimg deaktiviert. 

int getSoTimeout ( ) throws IOException 

liefert die Timeout-Angabe. 



Verbindungswünsche, für die mittels accept noch kein Socket 
erzeugt werden konnte, werden in einer Warteschlange 
( backlog ) verwaltet. Falls die Warteschlange voll ist und ein neu- 
er Verbindungswunsch eingeht, wird beim Client die Ausnahme 
java . net . connectException ausgelöst. Die maximale Länge der War- 
teschlange ist standardmäßig 50. 

Mit dem Konstruktor 

ServerSocket (int port, int backlog) throws IOException 

kann die maximale Länge der Warteschlange explizit festgelegt 
werden. 



1. Der Server erzeugt ein serverSocket-Objekt, das an einen vor- 
gegebenen Port gebunden wird. 

2. Der Server ruft die Methode accept des Server-Sockets auf und 
wartet auf den Verbindungswunsch eines Client. 

3. Der Client erzeugt ein socket-Objekt mit der Adresse und der 
Portnummer des Servers und versucht damit, eine Verbin- 
dung zum Server aufzunehmen. 

4. Der Server erzeugt ein Socket-Objekt, das das serverseitige 
Ende der Kommunikationsverbindung darstellt. Die Methode 
accept gibt dieses Objekt zurück. 

5. Lim eine bidirektionale Verbindung zwischen Client und Ser- 
ver aufzubauen, stellen Client und Server jeweils einen Aus- 
und Eingabestrom mit Hilfe ihrer socket-Objekte bereit. 

6. Nun können Daten mittels Lese- und Schreiboperationen hin- 
unci hergeschickt werden. 



4.3 Ein Echo-Server und -Client 
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Bild 4.3 zeigt den Ablauf beim Aufbau einer TCP-Verbindung. 



Server 



Client 



:Socket 



getlnputStreamQ 



getOutputStream() 






:ServerSocket 



accept() 



getlnputStream() 



getOutputStream() 



client:Socket 



3 



Die beiden Sockets sind miteinander verbunden. 



Weitere Socket-Methoden sind: 

Inet Address getLocalAddress ( ) 

liefert die lokale IP-Adresse, an die der Socket gebunden ist. 

int getLocalPort ( ) 

liefert die lokale Portnummer, an die der Socket gebunden ist. 

InetAddress getlnetfiddress () 

liefert die entfernte IP-Adresse, mit der der Socket verbunden ist. 

int getPortO 

liefert die entfernte Portnummer, mit der der Socket verbunden 
ist. 



4.3 Ein Echo-Server und -Client 

Wir stellen nun eine verbindungsorientierte Version des Echo- 
Dienstes vor. 

Der Client schickt in einer Schleife jeweils eine Textzeile zum 
Server, der diese dann wieder an den Client zurückschickt. Die 
Eingabe erfolgt über Tastatur. 



Bild 43: 

Aiifl/au einer TCP- 
Verbindung 



Socket- 

Informationen 



Programm 4.1 



Hier ist zunächst der Client: 
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EcboClient 



Die eigentliche Verarbeitung findet in einer try-Anweisung statt. 
Die Verbindung zum Server wird am Ende mit socket. dose () 
abgebaut. 



Import java.io.*; 
import java.net.*; 

public dass EchoClient { 

public static void main (String [ ] args) { 

Socket socket = null; 
try { 

String host = args[0]; 

int port = Integer. parseint (args [1] ) ; 

socket = new Socket (host, port) ; 

BufferedReader in = new Buf feredReader ( 

new InputStreamReader (socket. getlnputStream ( ) ) ) ; 
PrintWriter out = new PrintWriter( 
socket . getOutputStream ( ) , true) ; 

BufferedReader input = new Buf feredReader ( 
new InputStreamReader (System. in) ) ; 

String msg = in . readLine ( ) ; 

System, out .printin (msg) ; 

String line; 
while (true) { 

line = input. readLine () ; 
if (line m null | | line.equals ("q") ) 
break; 

out .printin (line) ; 

System . out . printin ( in . readLine ( ) ) ; 



in.closeO ; 
out . close ( ) ; 
input . close ( ) ; 

} 

catch (Exception e) { 
System, err .printin (e) ; 

} 

finally { 
try { 

if (socket != null) 
socket. close () ; 

} 

catch (IOException e) { } 




Zunächst wird ein Client-Socket erzeugt und damit versucht, die 
Verbindung zum Server herzustellen. Das BufferedReader-Objekt in 



4.3 Ein Echo-Server und -Client 
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ist der Eingabestrom, das Printwriter-Objekt out der Ausgabe- 
strom für diesen Socket. 

Dann wird eine Nachricht des Servers ausgegeben. In einer 
Schleife werden nun von der Tastatur Textzeilen eingelesen, in 
den Ausgabestrom out geschrieben und damit zum Server ge- 
schickt. in.readLinet) blockiert so lange, bis die Antwort vom 
Server vorliegt. Diese wird dann angezeigt. 



Wir zeigen zwei Server- Versionen. Die erste Version kann nicht 
mehrere Clients gleichzeitig bedienen. Werden z.B. zwei Clients 
kurz hintereinander gestartet, so werden sie der Reihe nach be- 
dient. Erst wenn der erste Client beendet wurde, kommt der 
zweite zum Zuge. Es handelt sich also um einen so genannten 
iterativen Server. 



Import java.io.*; 

Import java.net.*; 

public dass EchoServerl ( 
private int port; 
private int backlog; 

public EchoServerl (int port, int backlog) { 
this.port = port; 
this. backlog = backlog; 

} 



public void Startserver ( ) { 
try { 

ServerSocket Server = new ServerSocket (port, backlog) ; 

InetAddress addr = InetAddress . getLocalHost () ; 

System. out ,println( "EchoServerl auf " + 

addr . getHostName ( ) + "/" + addr.getHostAddress () + 

" : " + port + " gestartet ..."); 

process (Server) ; 

} 

catch (IOException e) { 

System, err .printin (e) ; 

} 



private void process (ServerSocket Server) throws IOException { 
while (true) { 

Socket Client = Server. accept () ; 

String clientAddr = dient. getlnetAddress () . getHostAddress ( ) ; 
int clientPort = dient. getPort () ; 

System, out .println( "Verbindung zu " + 

clientAddr + + clientPort + " aufgebaut"); 
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try { 

BufferedReader in = new Buf feredReader ( 

new InputStreamReader (dient. getlnputStreamO ) ) ; 
PrintWriter out = new PrintWriter( 

Client. getOutputStream() , true) ; 

out .printin ("Server ist bereit ..."); 

String input; 

while ((input = in.readLine () ) != null) ( 
out .printin (input) ; 

} 



in.close () ; 
out . close ( ) ; 

} 

catch (IOException e) { 

System. err .printin (e) ; 

) 

finally { 
try { 

if (Client != null) 

Client . close ( ) ; 

} 

catch (IOException e) ( } 

System.out.println ("Verbindung zu " + 

clientAddr + + clientPort + " abgebaut"); 

} 

) 

} 



public static void main (String [ ] args) { 
if (args.length != 1 && args.length != 2) ( 

System. err. printin ("java EchoServerl <port> [<backlog>] ") ; 
System. exit (1) ; 

} 



int port = Integer .parseint (args [0] ) ; 
int backlog = 50; 
if (args.length = 2) 

backlog = Integer. parseint (args [1] ) ; 

new EchoServerl (port, backlog) . startServer ( ) ; 

} 

} 



Der Server-Socket wird erzeugt und an die vorgegebene Port- 
nummer des lokalen Rechners gebunden. Hier wird auch die 
maximale Länge der Warteschlange ( backlog) vorgegeben. Somit 
kann das Verhalten der Anwendung mit unterschiedlichen Wer- 
ten getestet werden. 

Je Schleifendurchgang in der Methode process erfolgen diese 
Schritte: 
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• Aufruf der Methode accept, die so lange blockiert, bis ein 
Client versucht, Verbindung aufzunehmen. 

• Bereitstellung der Ein- und Ausgabeströme in und out. 

• Sendung einer Nachricht an den Client. 

• In einer Schleife werden Textzeilen eingelesen und sofort in 
den Ausgabestrom geschrieben. Die Schleife läuft so lange, 
bis der Client die Verbindung und damit seinen Ausgabe- 
strom geschlossen hat. 

• Der Socket wird geschlossen. 



Aufruf des Servers: Test 

Start java -cp build EchoServerl 50000 

Aufruf des Client: 

java -cp build EchoClient localhost 50000 



Der Server meldet den Auf- und Abbau der Verbindung: 

EchoServerl auf pc0806/127. 0.0. 1:50000 gestartet ... 

Verbindung zu 127.0.0.1:2634 aufgebaut 
Verbindung zu 127.0.0.1:2634 abgebaut 

Der Server kann über Tastatur mit strg+c abgebrochen werden. 



Die zweite Version des Echo-Servers ermöglicht die parallele EchoSewer2 
Bedienung mehrerer Clients. Dazu erfolgt die Kommunikation 
mit einem Client innerhalb eines Threads. 



Import java. io.*; 
import java.net.*; 

public dass EchoServer2 { 
private int port; 

public EchoServer2 (int port) ( 
this.port = port; 

} 



public void Startserver ( ) { 
try { 

ServerSocket Server = new ServerSocket (port) ; 

InetAddress addr = InetAddress . getLocalHost ( ) ; 
System. out. printin ( "EchoServer2 auf " + 

addr . getHostName ( ) + "/" + addr.getHostAddress () + 
" : " + port + " gestartet ..."); 
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while (true) { 

Socket Client = Server . accept ( ) ; 
new EchoThread (Client) .Start (); 



catch (IOException e) { 
System, err .printin (e) ; 

) 



private dass EchoThread extends Thread ( 
private Socket Client; 

public EchoThread (Socket Client) ( 
this. Client = dient; 

} 



public void run() { 

String clientAddr = dient. getlnetAddress () . getHostAddress ( ) ; 

int clientPort = dient. getPort () ; 

System. out .printin ("Verbindung zu " + 

clientAddr + + clientPort + " aufgebaut"); 

try { 

BufferedReader in = new Buf feredReader ( 

new InputStreamReader (dient. getlnputStreamO ) ) ; 

PrintWriter out = new PrintWriter( 
dient. getOutputStream() , true); 

out .printin ("Server ist bereit ..."); 

String input; 

while ((input = in.readLine () ) != null) ( 
out .printin (input) ; 

} 



in.close () ; 
out . close ( ) ; 

> 

catch (IOException e) { 

System. err .printin (e) ; 

} 

finally { 
try { 

if (Client != null) 

Client . close ( ) ; 

} 

catch (IOException e) ( } 

System.out.println ("Verbindung zu " + 

clientAddr + + clientPort + " abgebaut"); 
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public static void main (String [] args) { 
int port = Integer .parseint (args [0] ) ; 
new EchoServer2 (port) . Startserver () ; 




Sobald die Methode accept einen Verbindungswunsch angenom- 
men hat, wird mit Hilfe des gelieferten Sockets ein EchoThread- 
Objekt erzeugt und dieser Thread dann gestartet. Sofort ist der 
Server wieder bereit, eine neue Verbindung aufzunehmen. Pro 
Verbindung existiert also ein eigener Thread, der den entspre- 
chenden Client bedient. 



4.4 Ein Download-Programm 

Client und Server des folgenden Beispiels ermöglichen das Her- 
unterladen von beliebigen Dateien aus einem vorgegebenen 
Verzeichnis. 



Kommandos: 





Folgende Kommandos kann der Client verwenden: 
üst Auflistung aller Dateinamen des Serververzeichnisses 

get <fiie> Download der Datei <fiie> 
g Beenden des Programms 



import java.io.*; 
import java.net.*; 

public dass FileServer { 
private int port; 
private File dir; 

public FileServer (int port, File dir) { 
this.port = port; 
this.dir = dir; 

} 
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public void startServer () { 
try { 

ServerSocket Server = new ServerSocket (port) ; 

InetAddress addr = InetAddress . getLocalHost ( ) ; 
System. out .printin ("FileServer auf " + 

addr . getHostName ( ) + "/" + addr . getHostAddress ( ) + 
" : " + port + " gestartet ..."); 

while (true) { 

Socket Client = Server . accept ( ) ; 
new FileThread (dient, dir) .Start () ; 



catch (IOException e) { 
System. err. printin (e) ; 

} 



private dass FileThread extends Thread ( 

private final static long MAX_SIZE = 1024 * 1024; // 1 MB 

private final static int TIMEOUT = 600000; // 10 Min. 

private Socket Client; 

private File dir; 

private ObjectlnputStream in; 

private ObjectOutputStream out; 

public FileThread (Socket dient, File dir) { 
this. Client = dient; 
this.dir = dir; 

} 



public void run() { 

String clientAddr = dient. getlnetAddress () . getHostAddress () ; 
int clientPort = dient. getPort () ; 

System. out .printin ("Verbindung zu " + 

clientAddr + + clientPort + " aufgebaut"); 

try { 

dient . setSoTimeout (TIMEOUT) ; 

out = new ObjectOutputStream (dient. getOutputStream() ) ; 
out.flush() ; 

in = new Cb jectlnputStream (dient. getlnputStreamQ ) ; 

while (true) { 

String cmd = (String) in . readOb ject ( ) ; 
if (cmd.eguals ("list") ) < 
doList ( ) ; 

) 

eise if (cmd.startsWithC'get ")) ( 

String file = cmd. substring (4) .trim(); 
doGet (file) ; 

) 

eise if (cmd.eguals ("g") ) ( 
break; 

} 

} 
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in . close ( ) ; 
out.closeO ; 

> 

catch (EOFException e) { } 
catch (Exception e) { 

System. err .printin (e) ; 

} 

finally { 
try { 

if (Client != null) 

Client . close ( ) ; 

} 

catch (IOException e) { } 

System. out. printin ("Verbindung zu " + 

clientAddr + + clientPort + " abgebaut"); 




private void doListO throws IOException ( 

// Verzeichnisnamen werden nicht zurückgegeben 
File [ ] f iles = dir . listFiles (new FileFilter ( ) { 
public boolean accept (File pathname) { 
if (pathname . isFile ( ) ) 
retum true; 
eise 

retum false; 



)); 

out.writeObject (files) ; 
out . f lush ( ) ; 



private void doGet (String file) throws IOException { 

File f = new File (dir, file) ; 
if (!f. isFile ()) { 

FileNotFoundException e = new FileNotFoundException (file) ; 
out .writeOb ject (e) ; 
out. f lush () ; 
retum; 

) 

if (f.lengthQ > MAX_SIZE) { 

Exception e = new Exception (file + " ist zu gross"); 
out .writeOb ject (e) ; 
out. f lush () ; 
return; 



BufferedlnputStream fin = null; 
try ( 

ByteArrayOutputStream bout = new ByteArrayOutputStreamO ; 
fin = new BufferedlnputStream (new FilelnputStream(f) ) ; 
byte[] b = new byte[1024]; 
int c; 

while ( (c = fin.read(b)) != -1) { 
bout.write(b, 0, c) ; 
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Achtung 



byte t ] bytes = bout . toByteArray ( ) ; 
out .writeObject (bytes) ; 

} 

catch (IOException e) { 

System. err. printin (e) ; 

} 

finally { 
try { 

if (fin != null) 
f in . close ( ) ; 

} 

catch (IOException e) < } 




public static void main (String [ ] args) { 
if (args.length != 2) { 

System. err .printin ("java FileServer <port> <dir>"); 
System. exit (1) ; 

} 



int port = Integer .parseint (args [0] ) ; 

File dir = new File (args [1] ) ; 
if ( ! dir . isDirectory ( ) ) { 

System. err .printin (args [1] + " ist kein Verzeichnis"); 
System. exit (1) ; 



new FileServer (port, dir) .startServer () ; 

} 

} 



Der Server wird mit den Parametern Portnummer und Verzeich- 
nis aufgerufen. Zu Beginn wird geprüft, ob der zweite Parameter 
ein gültiges Verzeichnis bezeichnet. Die Kommunikation mit 
dem Client findet in einem clientbezogenen Threacl statt (run- 
Methode). Bleibt der Client 10 Minuten inaktiv, wird die Verbin- 
dung abgebrochen. 

Über den Eingabestrom in (vom Typ objectinputstream) werden 
die Kommandos (string-Objekte) des Client gelesen. Über den 
Ausgabestrom out (vom Typ objectoutputstream) werden Objekte 
unterschiedlicher Typen (Dateilisten, Byte-Arrays mit dem Datei- 
inhalt, Exceptions) an den Client gesendet. 



Bei der Verwendung von Objectinputstream und ObjectOutputStream 
für die Kommunikation über Sockets ist Folgendes zu beachten: 

Der objectoutputstream-Konstruktor schreibt den so genannten 
Serialization Stream Header in den Ausgabestrom. 

Der objectinputstream-Konstruktor blockiert, bis der zugeordnete 
Objectoutputstream den Header geschrieben hat. Deshalb sollte 
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unmittelbar nach dem Aufruf des objectOutputstream-Konstruktors 
der Puffer mittels fiusho geleert werden. 

Diese Verhaltenweise wird im Client- und Serverprogramm be- 
rücksichtigt, ansonsten würden sich die Programme gegenseitig 
blockieren. 



Zum Kommando list: 

Alle Dateinamen (keine Namen von Unterverzeichnissen) des 
Serververzeichnisses werden in den Ausgabestrom als Array vom 
Typ File geschrieben. 

Zum Kommando get: 

Wird die angeforderte Datei im Serververzeichnis nicht gefunden 
oder überschreitet die Dateigröße den Maximalwert max_size, so 
wird ein Objekt vom Typ Exception in den Ausgabestrom ge- 
schrieben. Ansonsten wird die Datei in ein Byte-Array übertragen 
und dieses dann in den Ausgabestrom geschrieben. 



import java.io.*; 
import java.net.*; 

public dass FileClient { 
private String host; 
private int port; 
private File dir; 
private ObjectlnputStream in; 
private ObjectOutputStream out; 
private BufferedReader input; 

public FileClient (String host, int port, File dir) { 
this.host = host; 
this.port = port; 
this.dir = dir; 

} 



public void doWorkO { 

Socket socket = null; 
try { 

socket = new Socket (host, port) ; 

in = new ObjectlnputStream (socket. getlnputStreamQ ) ; 
out = new Cb jectOutputStream (socket. getOutputStream() ) ; 
out.flush() ; 

input = new BufferedReader (new InputStreamReader (System. in) ) ; 

while (true) < 

System, out .printin ( 

"Kommando eingeben (list | get <file> | q):"); 

String cmd = input. readLine () ; 
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if (cmd = null | | cmd.equals ("q") ) { 
doQuit () ; 
break; 

} 

if (cmd.equals ("list") ) { 
doList () ; 

} 

eise if (cmd.startsWith("qet ")) { 

Strinq file = cmd.substrinq(4) ,trim(); 
doGet (file) ; 

} 

eise 

System. out. printin ( "Ungueltiger Befehl") ; 



in.closeO ; 
out . close ( ) ; 
input . close ( ) ; 

} 

catch (Exception e) { 
System, err .printin (e) ; 

} 

finally { 
try { 

if (socket != null) 
socket. close () ; 

} 

catch (IOException e) { ) 




private void doQuit ( ) throws IOException ( 
out .writeObject ("q") ; 

} 



private void doList ( ) throws IOException, ClassNotFoundException ( 
out .writeObject ("list") ; 

File[] files = (File[]) in . readOb ject () ; 
for (File f : files) { 

System. out .printin (f .qetName () ) ; 

} 

} 



private void doGet (String file) throws IOException, 
ClassNotFoundException ( 

out. writeOb ject ("get " + file); 

Object ob j = in . readOb ject ( ) ; 

if (obj instanceof Exception) { 

System. out .printin (obj ) ; 
retum; 



BufferedOutputStream fout = null; 
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try { 

File f = new File (dir, file) ; 

ByteArraylnputStream bin = new ByteArraylnputStream ( 
(byte[] )obj) ; 

fout = new Buff eredOutputStream (new FileOutputStream(f) ) ; 
byte[] b = new byte[1024]; 
int c; 

while ( (c = bin. read (b) ) != -1) { 
fout.write(b, 0, c) ; 

} 

> 

catch (IOException e) { 

System. err .printin (e) ; 

} 

finally ( 
try { 

if (fout != null) 
fout.closeO ; 

> 

catch (IOException e) { } 

System. out .printin (file + " wurde uebertragen" ) ; 




public static void main (String [] args) ( 
if (args.length != 3) ( 

System. err .printin ("java FileClient <host> <port> <dir>"); 
System. exit (1) ; 

) 



String host = args[0]; 

int port = Integer .parseint (args [1] ) ; 

File dir = new File (args [2] ) ; 
if ( ! dir . isDirectory ( ) ) { 

System. err .printin (args [2] + " ist kein Verzeichnis"); 
System. exit (1) ; 



new FileClient (host, port, dir ) . doWork ( ) ; 

} 

) 



Der Client wird mit den Parametern Rechnername, Portnummer 
und lokales Verzeichnis aufgerufen. Die übertragenen Dateien 
werden in dem vorgegebenen Verzeichnis gespeichert. 

Zu Beginn wird geprüft, ob der dritte Parameter ein gültiges 
Verzeichnis bezeichnet. 

Über den Ausgabestrom out werden die Kommandos gesendet. 
Über den Eingabestrom in werden Objekte gelesen und entspre- 
chend ihrem Typ verarbeitet: Ausgabe einer Liste von Dateina- 
men, Speicherung des übertragenen Dateiinhalts, Ausgabe der 
Fehlermeldungen. 
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ChatServer 



4.5 Ein Chat-Programm 

Mit dem Chat-Client ist das so genannte "Chatten" mit mehreren 
Teilnehmern im Netz möglich. Der Teilnehmer kann sich an- 
und abmelden und Textzeilen an alle anderen aktiven Teilneh- 
mer senden. Der Chat-Server registriert die angemeldeten Teil- 
nehmer und verteilt eingehende Nachrichten an alle registrierten 
Teilnehmer. Der Chat-Client wird sowohl als Applikation mit 
grafischer Oberfläche als auch als Applet realisiert. 



Import java.io.*; 
import java.net.*; 
import java.util.*; 

public dass ChatServer { 

private static Vector<PrintWriter> manager = 
new Vector<PrintWriter> ( ) ; 
private int port; 

public ChatServer (int port) ( 
this.port = port; 

} 



public void startServer () { 
try { 

ServerSocket Server = new ServerSocket (port) ; 

InetAddress addr = InetAddress . getLocalHost ( ) ; 
System. out .printin ("ChatServer auf " + 

addr . getHostName ( ) + "/" + addr . getHostAddress ( ) + 
" : " + port + " gestartet ..."); 

while (true) { 

Socket Client = Server . accept ( ) ; 
new ChatThread (dient) .Start (); 



catch (IOException e) { 
System. err. printin (e) ; 

} 



private dass ChatThread extends Thread ( 

private final static int TIMEOUT = 600000; // 10 Min. 

private Socket dient; 

private String name; 

private BufferedReader in; 

private PrintWriter out; 

public ChatThread (Socket dient) { 
this. Client = dient; 
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public void run() ( 

String clientAddr = dient. getlnetAddress () .getHostAddress () ; 
int clientPort = dient. getPort () ; 

try { 

dient . setSoTirreout (TIMEOUT) ; 
in = new Buf f eredReader ( 

new InputStrearriReader (dient. getlnputStreamO ) ) ; 
out = new PrintWriter (dient. getOutputStream ( ) , true) ; 

login ( ) ; 

System. out. printin ("Verbindung zu " + 

clientAddr + " : " + clientPort + " aufgebaut : " + name) ; 

String message; 

while ((message = in . readLine ( ) ) != null) { 
sendMessage (name + " : " + message) ; 

} 

in . close ( ) ; 
out.closeO ; 

) 

catch (IOException e) { 

System. err .printin (e) ; 

) 

finally { 
logout () ; 

try ( 

if (Client != null) 

Client . close ( ) ; 

} 

catch (IOException e) { } 

System.out.println ("Verbindung zu " + 

clientAddr + + clientPort + " abgebaut: " + name); 

> 

> 



private void login () throws IOException { 
manager.add(out) ; 
name = in . readLine ( ) ; 

sencMes sage (name + " ist dazugekommen"); 

> 



private void logout () { 
manager . remove (out) ; 

sendMes sage (name + " hat sich verabschiedet"); 
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private void sendMessage (String message) { 
synchronized (manager) { 

for (PrintWriter out : manager) { 
out .printin (message) ; 




public static void main (String [ ] args) { 
int port = Integer .parseint (args [0] ) ; 
new ChatServer (port) . Startserver ( ) ; 




Das Programmgerüst entspricht den in den letzten Abschnitten 
behandelten Beispielen. Kernstück des Programms ist die run- 
Methode. 

Der Server verwaltet ein vector-Objekt manager, das für alle Thread- 
Objekte dasselbe ist (Klassenvariable). Mit Hilfe dieses Objekts 
"merkt" sich der Server, wer sich als Teilnehmer angemeldet hat. 
Nach Aufnahme der Verbindung wird die Referenz out auf den 
Ausgabestrom für diesen Teilnehmer im Vektor gespeichert (sie- 
he Methode login) und am Ende aus dem Vektor wieder entfernt 
(siehe Methode logout). 

Die erste Textzeile, die der Server über in erhält, ist der Login- 
Name des Teilnehmers. Alle anderen empfangenen Zeilen sind 
Nachrichten des Teilnehmers an alle aktiven Teilnehmer. Alle 
Nachrichten werden mit dem Teilnehmernamen versehen und 
mit der Methode sendMassage an alle angemeldeten Teilnehmer 
gesendet (siehe Bild 4.5). Mit derselben Methode werden die 
Teilnehmer darüber informiert, wer sich an- oder abgemeldet 
hat. 
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Der Chat-Client ist so programmiert, dass er als Applet oder als 
eigenständige Applikation eingesetzt werden kann. 

Das Einlesen der Nachrichten vom Server erfolgt in einem eige- 
nen Threacl (siehe run-Methode), der in der Methode login gestar- 
tet wird. 



irnport java.io.*; 
import java.net.*; 
irnport java.awt.*; 
irnport java.awt.event.*; 
irnport javax . swing . * ; 

public dass ChatClient extends JApplet implements Runnable, 
ActionListener { 

private final static int width = 500; 
private final static int hight = 400; 

private JLabel label; 
private JTextArea area; 
private JTextField text; 
private JButton button; 

private String host; 
private int port; 
private Socket socket; 
private BufferedReader in; 
private BufferedWriter out; 

private volatile Thread t; 
private boolean login = false; 
private String name; 

// Wird verwendet, um den Client als Applikation zu starten, 
private static JFrame frame; 

// Korrmandozeilenparameter für die Socket-Initialisierung 
private static String [] cmdLineArgs; 

// Der Client kann auch als Applikation gestartet werden. 

// Dies wird ermöglicht, indem ein Frame für das Applet 
// zur Verfügung gestellt wird, 
static public void main (String [] args) { 
if (args.length != 2) { 

System . err . print ln ( " java ChatClient <host> <port> " ) ; 
System, exit (1) ; 

} 



// Wird für Socket-Initialisierung benötigt. 
cmdLineArgs = args; 
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// Der Client 

final ChatClient dient = new ChatClient () ; 

frame = new JFrame ("Chat -Client") ; 
frame . addWindowListener (new WindowAdapter ( ) ( 
public void windowClosing (WindowEvent e) { 
Client .destroy () ; 

System. exit (0) ; 



)); 

Client . init ( ) ; 

frame . getContentPane ( ) . add ( dient ) ; 
frame . setSize (width, hight) ; 
frame . setvisible (true) ; 



public ChatClient () { 
label = new JLabel (" ") ; 

JPanel top = new JPanel ( ) ; 
top. add (label) ; 

area = new JTextArea ( ) ; 

area. setFont (new Font ("Monospaced", Font.PLAIN, 14)); 
area . setLineWrap (true) ; 
area . setEditable ( false) ; 

text = new JTextField(48); 

text. setFont (new Font ("Monospaced", Font.PLAIN, 14)); 

text . setEnabled (false) ; 

text .addActionListener (this) ; 

button = new JButton ( "Login" ) ; 
button. setEnabled (false) ; 
button . addActionListener (this) ; 

JPanel input = new JPanel ( ) ; 

input . setLayout (new FlowLayout (FlowLayout . LEFT, 10, 10)); 
input . add (text) ; 
input . add (button) ; 

Container c = getContentPane () ; 
c. add (top, BorderLayout. NORTH) ; 

c. add (new JScrollPane (area) , BorderLayout . CENTER) ; 
c.add(input, BorderLayout . SOUTH) ; 



// Verbindungsparameter werden bereitgestellt, 
public void init ( ) { 
if (frame = null) { 
host = get CodeBase ( ) .getHost () ; 
port = Integer. parseint (getParameter ("port") ) ; 

} 

eise { 

host = cmdLineArgs [0] ; 

port = Int eger. parseint (cmdLineArgs [1] ) ; 
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text . setEnabled (true) ; 
text . requestFocus ( ) ; 
button . setEnabled (true) ; 



// Die gewünschte Benutzer-Aktion wird ausgeführt, 
public void actionPerformed (ActionEvent e) { 

Object ob j = e . getSource ( ) ; 

String cmd = e.getActionCorrmandO ; 

try { 

if (obj = button) ( 

if (cmd. eguals ("Login") ) { 
name = text. get Text () ; 
if (name . length ( ) != 0) { 
login () ; 



eise ( 

destroy () ; 

} 



if (obj = text) { 
if (login) ( 

out .write (text .get Text () ) ; 
out . newLine ( ) ; 
out . f lush ( ) ; 



catch (IOException ex) { 

area . append (ex . getMessage ( ) + " \n" ) ; 
destroy ( ) ; 

) 

finally ( 
text . setText ( " " ) ; 
text . requestFocus () ; 



// Login beim Server 

private void login () throws IOException { 
socket = new Socket (host, port) ; 
in = new Buf feredReader ( 

new InputStreamReader ( socket . getlnputStream ( ) ) ) ; 
out = new Buf feredWriter ( 

new OutputStreamWriter (socket. getOutputStream ( ) ) ) ; 

out .write (name) ; 
out . newLine ( ) ; 
out . f lush ( ) ; 
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login = true; 

label . setText (narre) ; 

button . setText ( "Logout" ) ; 

t = new Thread(this) ; 
t . Start ( ) ; 



// Logout beim Server 
public void destroyO { 
if (login) { 
try { 

login = false; 
label . setText ( " " ) ; 
button. setText ("Login") ; 
t = null; 

if (socket != null) 
socket. closeO ; 
if (in != null) 
in. closeO ; 
if (out != null) 
out.close () ; 

} 

catch (IOException e) { } 




public void run() { 
try { 

while (Thread.currentThreadQ = t) ( 
final String msg = in.readLine () ; 
if (msg = null) 
break; 

doUpdate (new Runnable ( ) { 
public void run() { 

area . append (msg + "\n"); 



}); 



catch (IOException e) { } 

} 



private void doUpdate (Runnable r) ( 
try ( 

EventQueue . invokeLater (r ) ; 

} 



catch (Exception e) { } 
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4.6 Klassen über das Netz laden 

In Java müssen Klassen erst dann physisch vorhanden sein, 
wenn sie verwendet werden sollen ( dynamisches Laden von 
Klassen). Ein so genannter Klassenlader ist verantwortlich für das 
Auffinden und Laden von Klassen. 

Die Klasse java.iang.ciassLoader ist eine abstrakte Klasse. Sie ent- 
hält die Methode loadciass, die die Klasse mit dem angegebenen 
Namen lädt: 

public Class<?> loadClass (String name) throws ClassNotFoundException 

Ein eigener Klassenlader (als Subklasse von ciassLoader) kann 
z.B. eine Klasse über das Netz laden. 

Hierzu muss nur die ciassLoader-Methode 

protected Class<?> findClass (String name) 
throws ClassNotFoundException 

in geeigneter Weise überschrieben werden. 



Im Folgenden entwickeln wir einen Server (ciassServer), der auf 
Anfrage eine Klasse in seinem Serververzeichnis sucht und den 
Inhalt als Byte-Array liefert. 

Der Client (NetworkciassLoader) überschreibt als Subklasse von 
ciassLoader die Methode findClass. Dazu nutzt er die ciassLoader- 
Methode defineciass, um aus dem vom Server gelieferten Byte- 
Array ein ciass-Objekt zu erzeugen: 



Bild 4.6: 

Chat-Client 



CiassLoader 



Programm 4.4 
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protected final Class<?> defineClass ( 

String name, byte[] b, int off, int len) 



Beim Einsatz eines Programms mit eigenem Klassenlader ist ge- 
nerell zu beachten: 

Es wird versucht, weitere in der soeben geladenen Klasse refe- 
renzierte Klassen mit dem gleichen Klassenlader zu laden, mit 
dem auch die erste Klasse geladen wurde. 

Befindet sich das aufgerufene Programm (die Start-Klasse) und 
die zu ladende Klasse im gleichen Klassenpfad, so wird diese 
Klasse vom Standard-Klassenlader des Systems und nicht vom 
eigenen Klassenlader geladen. 



Der Server wird mit Portnummer und Suchpfad aufgerufen. Da 
der Name der angeforderten Klasse auch den Paketnamen ent- 
halten kann, werden Punkte durch Schrägstriche ersetzt und 
somit die einzelnen Teile des Paketnamens auf Verzeichnisna- 
men abgebildet. 



import java.io.*; 
import java.net.*; 

public dass ClassServer extends Thread ( 
private int port; 
private String searcbPath; 

public ClassServer (int port, String searchPath) { 
this.port = port; 
this . searchPath = searchPath; 

} 



public void Startserver () { 
try { 

ServerSocket Server = new ServerSocket (port) ; 

InetAddress addr = InetAddress . getLocalHost ( ) ; 
System. out .printin ("ClassServer auf " + 

addr . getHostName ( ) + "/" + addr . getHostAddress ( ) + 
" : " + port + " gestartet ..."); 

while (true) { 

Socket Client = Server . accept ( ) ; 

new ClassThread (Client, searchPath) .Start (); 



catch (IOException e) { 
System. err .printin (e) ; 
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private dass ClassThread extends Thread { 
private Socket dient; 
private String searchPath; 

public ClassThread (Socket dient, String searchPath) { 
this. Client = dient; 
this . searchPath = searchPath; 

> 



public void run() ( 

String clientAddr = dient. getlnetAddress () .getHostAddress () ; 
int clientPort = dient. getPort () ; 

System, out ,println( "Verbindung zu " + 

clientAddr + + clientPort + " aufgebaut"); 

try ( 

BufferedReader in = new Buf feredReader ( 

new InputStreamReader (dient. getlnputStreamO ) ) ; 
ObjectOutputStream out = new Ob jectOutputStream ( 

Client .getOutputStream() ) ; 
out.flushQ ; 

String name = in . readLine ( ) ; 

name = name . replace ( ' . ' , ' / ' ) ; 

String classPath = searchPath + name + ".dass"; 

File file = new File (classPath) ; 
int length = (int) file.length() ; 

FilelnputStream fis = new FilelnputStream(file) ; 

byte data[] = new byte[length] ; 

int ent = 0; 

while (ent < length) { 

int result = fis . read (data, ent, length - ent); 
if (result = -1) 
break; 

ent += result; 

} 

fis.closeQ ; 

if (data != null) { 
out .writeöb ject (data) ; 
out . f lush ( ) ; 

} 

in . close ( ) ; 
out.closeO ; 

System.out.println("\"" + classPath + "\" gesendet"); 

) 

catch (IOException e) { 

System. err .printin (e) ; 
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finally { 
try { 

if (Client != null) 

Client . close ( ) ; 

} 

catch (IOException e) < } 

System.out.println( "Verbindung zu " + 

Client Addr + + clientPort + " abgebaut"); 

} 

} 

} 



public static void main (String [ ] args) { 
if (args.length != 2) { 

System. err. printin ("java ClassServer <port> <searchPath>") ; 
System. exit (1) ; 

} 



int port = Integer. parseint (args [0] ) ; 

String searcbPath = args[l]; 

searchPath = searcbPath . replace ( ' \\ ' , ' / ' ) ; 
if ( (searchPath. endsWith ("/") ) 
searchPath += 

new ClassServer (port, searchPath) . startServer ( ) ; 

} 

} 



import java. io.*; 
import java.net.*; 

public dass NetworkClassLoader extends ClassLoader { 
private String host; 
private int port; 

public NetworkClassLoader (String host, int port) { 
this.host = host; 
this.port = port; 

} 



public Class<?> findClass (String name) { 
byte [ ] b = loadClassData (name) ; 
retum defineClass (name, b, 0, b.length); 

} 



private byte[] loadClassData (String name) { 

Socket socket = null; 
try { 

socket = new Socket (host, port) ; 

ObjectlnputStream in = 

new Ob jectlnputStream ( socket. getlnputStreamQ ) ; 
PrintWriter out = new PrintWriter( 
socket . getdutputStream ( ) , true) ; 
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out .printin (name) ; 

Object obj = in . readOb ject () ; 
in.closeO ; 
out . close ( ) ; 
retum (byte [ ] ) ob j ; 

} 

catch (ConnectException e) { 
throw new RuntimeException ( 

"Verbindung zum Server konnte nicht hergestellt werden . " ) ; 

} 

catch (EOFException e) { 

throw new RuntimeException ("Klasse wurde nicht gefunden."); 

) 

catch (Exception e) { 

throw new RuntimeException (e) ; 

} 

finally { 
try ( 

if (socket != null) 
socket . close ( ) ; 

) 

catch (IOException e) { } 

) 




Das Programm Start wird mit den folgenden Parametern aufgeru- Start 
fern 

• Name bzw. IP-Adresse des entfernten Rechners 

• Portnummer des entfernten Rechners 

• Name der zu ladenden Klasse, die die main-Methode enthält 

• evtl. Aufrufparameter für die main-Methode 

Das Reflection-API wird genutzt, um die main-Methode der gela- 
denen Klasse mit evtl. Parametern aufzurufen. 



public dass Start < 

public static void main (String [] args) { 
if (args.length < 3) ( 

System, err .printin ( 

"java Start <host> <port> <className> [<paraml> ...]"); 
System. exit (1) ; 



String host = args[0]; 

int port = Integer .parseint (args [1] ) ; 

String className = args [2]; 

try { 

NetworkClassLoader loader = new NetworkClassLoader (host, port) ; 
Class c = loader . loadClass (className) ; 
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// Bereitstellung der main-Methode 
java.lang.reflect.Method m = c.getMethod( 
"main", new dass [] { String [] .dass} ) ; 

String [] params = new String[args.length —3]; 
for (int i = 3; i < args.length; i++) 
params [i - 3] = args[i]; 

// Aufruf der main-Methode mit evtl. Parametern 
m.invoke(null, newObject[] (params}); 

} 

catch (RuntimeException e) ( 

System, err .printin (e.getMessage () ) ; 

} 

catch (Exception e) { 

System. err. printin (e) ; 

} 




Zur Demonstration des Verfahrens kann z. B. das Programm 4.3 
(chatdient) genut2t werden. 



Bild 4.7: 

Dynamisches Laden 
über das Netz 



ClassServer 




Rechner A Rechner B 

10.108.105.96 



Das Laden unbekannter Klassen aus dem Netz stellt ein Sicher- 
heitsrisiko dar. Eine Möglichkeit, sich zu schützen, besteht darin, 
den Security Manager zu nutzen und nur so viele Zugriffsrechte 
wie nötig für die Ausführung der Anwendung zuzulassen. 

Die Zugriffsrechte, passend zum obigen Beispiel, werden in 
einer Policy-Datei beschrieben: 
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grant { 

permission java. lang. RmtimePermission "createClassLoader"; 
permission java.lang.RuntiniePerTnission "exitVM"; 
permission java.net.SocketPermission "10.108.105.96:40000", 
"connect"; 

permission java.net.SocketPermission "10.108.105.96:50000", 
"connect"; 

permission java . awt . AWTPermission " showWindowWithoutWamingBanner " ; 



Aufruf des Start-Programms (Kommando in einer Zeile): 

java -D java. security. manager -D java. Security .policy= policy.txt 
-cp build Start 10.108.105.96 40000 ChatClient 10.108.105.96 50000 



4.7 Remote Procedure Call 

In diesem Abschnitt entwickeln wir ein allgemeingültiges einfa- 
ches Verfahren zum Aufruf von Methoden, die auf einem ent- 
fernten Rechner implementiert sind (RPC = Remote Procedure 
Call). 

Einzige Voraussetzung ist: Die Parameterwerte einer entfernten 
Methode müssen Objekte sein. Die Klassen aller Objekte (Rück- 
gabewert und Parameterwerte) müssen das Interface java. io. 
seriaiizabie implementieren. 

Der Client ruft die gewünschte Methode mit Hilfe von 

Object call (String name, Object [] params) 

der Klasse Rpcciient auf. name ist der Methodenname, params ent- 
hält die Parameterwerte. 



Beispiel: 

Lautet die Deklaration der entfernten Methode 

public int getSumme (Integer x, Integer y), 

so sieht der Codeabschnitt des Clients für den Aufruf beispiels- 
weise so aus: 

Object [] params = (10, 33}; 

int summe = (Integer) rpcClient . call ("getSunme", params); 



Die Klasse RPCClient nutzt die Methoden writeObject und readObject 
der Klassen ObjectOutputStream bzw. ObjectlnputStream, um den 
Methodennamen, das Parameter-Array und den Rückgabewert 
über das Netz zu transferieren. Bei einem Rückgabewert vom 
Typ Exception wird eine Ausnahme dieses Typs ausgelöst. 



policy.txt 



Programm 4.5 



RPCClient 
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import java.io.*; 
import java.net.*; 

public dass RPCClient { 
private String host; 
private int port; 

public RPCClient (String host, int port) ( 
this.host = host; 
this.port = port; 

} 



public Object call (String name, Object [] params) throws Exception { 
Socket socket = null; 
try { 

socket = new Socket (host, port) ; 

ObjectOutputStream out = new ObjectOutputStream( 
socket . getOutputStream ()); 
out .writeObject (name) ; 
out .writeObject (params) ; 
out . f lush ( ) ; 

ObjectlnputStream in = new ObjectInputStream( 
socket. getlnputStream ( ) ) ; 

Object ret = in . readOb ject () ; 

in.closeO ; 
out . close ( ) ; 

if (ret instanceof Exception) 
throw (Exception) ret; 

return ret; 

} 

finally { 
try { 

if (socket != null) 
socket. close () ; 

} 

catch (IOException e) { ) 

} 




Die Klasse Rpcserver nutzt das Reflection-API. Sie lädt diejenige 
Klasse (hier als Service bezeichnet), die die Implementierung der 
entfernten Methode enthält, und erzeugt eine Instanz dieser 
Klasse. 

Anhand des Methodennamens und der Parameterwerte, die vom 
Client als Objekte übermittelt wurden, wird mit Hilfe der ciass- 
Methode getMethod die gewünschte Methode des Service als 
Method-Objekt zur Verfügung gestellt. 
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Anschließend wird mit invoke die Service-Methode aufgerufen. 
Wenn die Service-Methode eine Ausnahme auslöst, so löst 
invoke die Ausnahme java.lang.reflect.InvocationTargetException 
aus. 

Die InvocationTargetException-Methode 
Throwable getTargetException ( ) 

gibt die von der aufgerufenen Service-Methode ausgelöste Aus- 
nahme zurück. 

Der Rpcserver liefert Ausnahmen (Typ Exception), die beim Suchen 
bzw. bei der Ausführung der Service-Methode auftreten können, 
als "normales" Ergebnisobjekt des Aufrufs zurück. 



import java.io.*; 

import java.net.*; 

import java.lang.reflect.*; 

public dass RPCServer extends Thread { 
private int port; 
private String Service; 

public RPCServer (int port, String Service) { 
this.port = port; 
this. Service = Service; 

} 

public void Startserver ( ) throws Exception { 
ServerSocket Server = new ServerSocket (port) ; 

InetAddress addr = InetAddress.getLocalHost () ; 

System . out . print ln ( "PPCServer auf " + 

addr . getHostName ( ) + "/" + addr.getHostAddress () + 
" : " + port + " gestartet ..."); 

System . out . print ln ( "Service : " + Service); 

Class serviceClass = Class . forName (Service) ; 

Object serviceObject = serviceClass.newInstanceO; 

while (true) { 

Socket Client = Server. accept () ; 

new RPCThread (dient, serviceObject) .Start () ; 



private class RPCThread extends Thread { 
private Socket dient; 
private Object serviceObject; 

public RPCThread (Socket dient, Object serviceObject) f 
this. Client = dient; 
this . serviceObject = serviceObject; 
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public void run() { 
try { 

ObjectlnputStream in = new ObjectInputStream( 

Client. getInputStream() ) ; 

String name = (String) in . readöb ject () ; 

Object [] params = (Object []) in. readöb ject () ; 

Class [ ] types = new dass [params . length] ; 
for (int i = 0; i < params . length; i++) 
types [i] = params [i] .getClassO; 

Object ret = null; 
try { 

Method m = serviceObject . getClass ( ) . getMethod (name, types); 
ret = m.invoke (serviceObject, params); 

} 

// Eine Ausnahme wird als Ergebnisobjekt zurückgeliefert 
catch (InvocationTargetException e) { 
ret = e.getTargetExceptionQ ; 

} 

catch (Exception e) { 
ret = e; 

} 



ObjectOutputStream out = new Ob jectOutputStream ( 
Client .getOutputStream () ) ; 
out. writeOb ject (ret) ; 
out . f lush ( ) ; 

in.close () ; 
out . close ( ) ; 

} 

catch (Exception e) { 

System. err .printin (e) ; 

} 

finally { 
try { 

if (dient != null) 

Client . close ( ) ; 

} 

catch (IOException e) ( } 




public static void main (String [ ] args) throws Exception { 
if (args. length != 2) { 

System. err. printin ("java RPCServer <port> <service>"); 
System. exit (1) ; 

} 



int port = Integer. parseint (args [0] ) ; 

String Service = args[l]; 

new RPCServer (port, Service) .Startserver () ; 
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Einige beispielhafte Service-Methoden sind in der Klasse Demo- 
service implementiert. Testciient enthält den Aufruf dieser Metho- 
den. 



import java.util.*; 
import java.io.*; 

public dass DemoService ( 

public String getEcho (String text) { 
retum text; 

} 



public int getSumme (Integer x. Integer y) ( 
retum x + y; 

} 



public Date getDateO { 
retum new Date ( ) ; 

} 



public void sendMessage (String msg) ( 
System, out .printin (msg) ; 

} 



public Vector<String> getMessages (String file) throws IOException ( 
Vector<String> lines = new Vector<String> ( ) ; 

BufferedReader in = new Buf feredReader (new FileReader (file) ) ; 
String line; 

while ((line = in . readLine ( ) ) != null) { 
lines. add (line) ; 

} 

in . close ( ) ; 
retum lines; 

} 

) 



import java.util.*; 
public dass Testclient { 

public static void main (String [] args) throws Exception { 
String host = args[0]; 
int port = Integer .parseint (args [1] ) ; 

RPCClient rpcClient = new RPCClient (host, port) ; 

Object [] paramsl = ("Hallo"}; 

String s = (String) rpcClient. call ("getEcho", paramsl); 
System . out . printin ( " getEcho : " + s ) ; 

Object [] params2 = (10, 33}; 

int summe = (Integer) rpcClient. call ("getSumme", params2); 
System, out .printin ("getSumme: " + suirme) ; 



Test 



Demo Service 



TestClient 
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Object [ ] params3 = { } ; 

Date date = (Date) rpcClient . call ("getDate", params3); 
System. out. printin ("getDate: " + date); 

Object [ ] paramsl = { "Dies ist ein Test . " } ; 
rpcClient .call ("sendMessage", params4) ; 

Object [] params5 = {"msg.txt"}; 

Vector<String> v = (Vector<String>) rpcClient . call ( 
"getMassages", params5) ; 

System . out .printin ( "getMessages : " ) ; 
for (String msg : v) { 

System, out .printin (msg) ; 

} 




Aufruf des Servers: 

Start java -cp build RPCServer 50000 DemoService 
Aufruf des Client: 

java -cp build Testclient localhost 50000 



4.8 Thread-Pooling 

Die Fähigkeit des Servers, mehrere Clients quasi gleichzeitig zu 
bedienen, wurde bisher so gelöst, dass für jede Anfrage eines 
Clients ein neuer Threacl erzeugt wurde. Im Vergleich zu Prozes- 
sen ist die Erzeugung eines Threads weniger aufwändig. Trotz- 
dem sollte man hiermit sparsam umgehen; insbesondere dann, 
wenn kurzzeitig sehr viele Threads mit kurzer Laufzeit benötigt 
werden. 

Ab der Version Java SE 5.0 gibt es die Möglichkeit, einen Thread- 
Pool einzusetzen. Dieser bietet die Möglichkeit, mehrere separate 
Aufgaben vom selben Thread nacheinander ausführen zu lassen. 
Nicht mehr benutzte Threads werden in den Pool zurückgelegt 
und können wiederverwendet werden. 

Wir benutzen hier eine spezielle Thread-Pool-Variante, einen so 
genannten Cached Thread Pool. Ein solcher Pool wächst bzw. 
schrumpft nach Bedarf. Steht eine neue Aufgabe (hier eine 
Client-Anfrage) zur Bearbeitung an und gibt es keinen "freien" 
Thread im Pool, so wird ein neuer erzeugt, der die Ausführung 
übernimmt. Ist die Aufgabe ausgeführt, steht dieser Thread als 
wieder "freier" Thread im Pool zur Verfügung. Wird er innerhalb 
von 60 Sekunden nicht benötigt, so wird er terminiert und ist 
dann nicht mehr verwendbar. Der Pool passt sich also dyna- 
misch den momentanen Anforderungen an und ist optimal für 
kleinere Aufgaben, clie in hoher Zahl kurzfristig anstehen. 
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Für unsere Zwecke benutzen wir die Klasse java.utii.concurrent. 
Executors und das Interface java.util. concurrent.ExecutorService. 



Die statische Executors-Methode 

static ExecutorService newCache<±rhreadPool ( ) 

erzeugt einen Cached Tbread Pool und liefert diesen als Objekt 
vont Typ ExecutorService Zurück. 



Das Interface ExecutorService enthält u.a. die folgenden Metho- 
den: 

void execute (Runnable task) 

führt die run-Methode von task in einem Thread des Pools aus. 

void shutdown() 

bewirkt, dass vor dem Aufruf dieser Methode übergebene Auf- 
gaben noch ausgeführt, neue aber nicht mehr akzeptiert werden; 
alle vom Pool verwalteten Threads werden dann terminiert. 

Damit ein Programm ordnungsgemäß beendet werden kann, 
muss der Pool mit der Methode shutdown kontrolliert terminiert 
werden. 



Programm 4.6 demonstriert den Einsatz eines Thread-Pools für Programm 4.6 
einen Server. 



import java.io.*; Server 

import java.net.*; 

import java.utii.concurrent.*; 

public dass Server { 
private int port; 

private ExecutorService pool; 

public Server (int port) { 
this.port = port; 

} 



public void Startserver ( ) { 
try { 

ServerSocket Server = new ServerSocket (port) ; 
System. out .printin ( "Server gestartet ..."); 

pool = Executors. newCachedThreadPool() ; 

while (true) ( 

Socket Client = Server. accept () ; 

pool . execute (new Händler (dient) ) ; 



} 
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catch (IOException e) { 
System. err .printin (e) ; 

pool . shutdown () ; 




private dass Händler implements Runnable { 
private Socket Client; 

public Händler (Socket Client) < 
this. Client = Client; 

} 



public void run() { 
try { 

BufferedReader in = new Buf feredReader ( 

new InputStreamReader (dient. getlnputStreamO ) ) ; 
PrintWriter out = new PrintWriter( 
dient. getOutputStream() , true) ; 

String input = in . readLine ( ) ; 
if (input != null) ( 

int delay = 5000 + (int) (Math. random () * 5000); 
try { 

Thread. sleep (delay) ; 

} 

catch (InterruptedException e) { ( 
out .printin ("Auftrag " + input + " nach " + delay + 
" ms abgeschlossen" ) ; 

} 



in.close () ; 
out . close ( ) ; 

> 

catch (IOException e) { 
System. err .printin (e) ; 

> 

finally { 
try { 

if (Client != null) 
Client . close ( ) ; 

} 

catch (IOException e) ( } 




public static void main (String [ ] args) { 
int port = Integer .parseint (args [0] ) ; 
new Server (port) .Startserver () ; 
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4.9 Ein Framework für TCP-Server 

Die Beispiele der vorhergehenden Abschnitte zeigen, dass die 
Implementierungen der TCP-Server im Großen und Ganzen fast 
immer dem gleichen Muster folgen. Es liegt also nahe, die immer 
wiederkehrenden Codeteile zu standardisieren und als Frame- 
ivork für eigene Server-Implementierungen anzubieten. 



Das Framework besteht aus den beiden Klassen TCPServer und Programm 4.7 
AbstractHandler, die ZUlll Paket tcpframework gehören. 

Der Konstruktor von TCPServer erwartet eine Portnummer und die 
Klasse des Händlers, der die eigentliche Kommunikation mit 
dem Client durchführt. Hier wird das ciass-Objekt des Händlers 
angegeben. Der Händler ist eine Subklasse von AbstractHandler. 

Innerhalb des Konstruktors werden ein serverSocket-Objekt und 
ein Thread-Pool (siehe Kapitel 4.8) erzeugt. 

TCPServer implementiert das Interface Runnabie. Innerhalb der run- 
Methode wird in einer Schleife die Methode accept aufgerufen. 

Mit dem zurückgegebenen socket-Objekt wird die handie-Methode 
aufgerufen. Diese erzeugt eine neue Instanz des Händlers und 
ruft für diese Instanz die Methode handle mit den Referenzen 
für das Socket-Objekt und den Thread-Pool auf. 

Die Methode stopserver schließt das ServerSocket-Objekt und ter- 
miniert den Thread-Pool. 



package tcpframework; 

iirport java . io . IOException; 

iirport java. net. Socket; 

irrport java . net . ServerSocket ; 

inport java . net . SocketException; 

irrport java . util . concurrent . Executors ; 

irrport java . util . concurrent . ExecutorService ; 

public dass TCPServer irrplements Runnabie { 
private int port; 
private Class handlerClass; 
private ServerSocket serverSocket; 
private ExecutorService pool; 

public TCPServer (int port, Class handlerClass) throws IOException { 
t hi s. port = port; 
this. handlerClass = handlerClass; 
serverSocket = new ServerSocket (port) ; 
pool = Executors . newCachedThreadPool ( ) ; 
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public void run() { 
try { 

while (true) { 

// Beim Aufruf von stopServerQ wird eine SocketException 
// ausgelöst 

Socket clientsocket = serverSocket . accept ( ) ; 
handle (clientSocket) ; 



catch (SocketException e) < } 
catch (Exception e) { 

System. err .printin (e) ; 

} 



public void stopServerQ { 
try { 

serverSocket . close ( ) ; 

} 

catch (IOException e) { } 
pool . shutdown ( ) ; 



private void handle (Socket clientSocket) throws Exception < 
AbstractHandler handler = (AbstractHandler) handlerClass . 
newlnstance ( ) ; 

handler. handle (clientSocket, pool); 




Ein konkreter Handler ist von AbstractHandler abgeleitet und im- 
plementiert die run-Methode. Diese wird durch die handie- 
Methode in einem Thread des Pools ausgeführt. Zudem wird das 
Socket-Objekt mit Hilfe der Methode getciientsocket dem Handler 
zur Verfügung gestellt. 



package tcpframework; 
import java.net. Socket; 

import java . util . concurrent . ExecutorService ; 

public abstract dass AbstractHandler implements Runnable { 
private Socket clientSocket; 

public Socket getciientsocket ( ) { 
retum clientSocket; 

} 



public void handle (Socket clientSocket, ExecutorService pool) { 
this . clientSocket = clientSocket; 
pool .execute (this) ; 

} 



public abstract void run ( ) ; 



4.9 Ein Framework für TCP-Server 
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Das Framework wird nun in einem Beispiel verwendet. Hierbei 
handelt es sich um den Echo-Server aus Kapitel 4 . 3 . 



iirport java . io . IOException; 
iirport tcpframework . *; 

public dass EchoServer { 

public static void main (String [] args) throws IOException { 
int port = Integer. parse Int (args [0] ) ; 

TCP Server Server = new TCPServer (port, EchoHandler.class) ; 

// Server wird in einem Thread gestartet 
Thread t = new Thread (Server) ; 
t. Start () ; 

System. out .print ln ( "Server gestartet ..."); 

// blockiert, bis RETURN eingegeben wurde 
Sy stem . in . read ( ) ; 

Server . stopServer ( ) ; 

System. out .print ln ( "Server gestoppt ..."); 




Der Server wird nach Betätigung der Return-Taste gestoppt; 
allerdings erst dann, wenn alle momentan aktiven Client- 
Bearbeitungen beendet sind. 



import java. io.*; 
import java. net. Socket; 
import tcpframework.*; 

public dass EchoHandler extends AbstractHandler { 
public void run() { 

Socket clientsocket = getClientSocket () ; 

String clientAddr = clientSocket. getlnetAddress () . 
getHost Address () ; 

int clientPort = clientSocket.getPort () ; 

System. out .print ln ("Verbindung zu " + 

clientAddr + + clientPort + " aufgebaut"); 

try { 

BufferedReader in = new Buf feredReader ( 

new InputStreamReader (clientSocket. getlnputStream ( ) ) ) ; 
PrintWriter out = new PrintWriter( 

clientSocket.getOutputStreamO , true) ; 

out. println(" Server ist bereit ..."); 



Anwendung des 
Frameworks 

EchoServer 



EchoHandler 



String input; 
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while ( (input = in . readLine ( ) ) != null) { 
out .printin (input) ; 

} 



in.closeO ; 
out . close ( ) ; 

} 

catch (IOException e) { 

System. err .printin (e) ; 

} 

finally { 
try { 

if (clientSocket != null) 
clientsocket . close () ; 

} 

catch (IOException e) { } 

System. out .printin ("Verbindung zu " + 

clientAddr + + clientPort + " abgebaut"); 

} 

} 

} 



Um mit dem Client zu kommunizieren, wird in der run-Methode 
das socket-Objekt über die Methode getciientsocket erfragt. Dann 
erfolgt das Empfangen und Senden der Daten. 



4.10 Aufgaben 

1. Entwickeln Sie einen TCP-Server, der als Reaktion auf die 
Verbindungsaufnahme durch den Client an diesen einen in 
einer Datei gespeicherten Text sendet und dann von sich 
aus die Verbindung beendet. 

Testen Sie den Server mit Hilfe von Telnet: 
telnet localhost 50000 

2. Entwickeln Sie einen TCP-Server, der die aktuelle Systemzeit 
des Servers als Zeichenkette liefert. Programmieren Sie auch 
einen passenden Client hierzu. 

3. Entwickeln Sie einen Echo-Server, der die parallele Bedie- 
nung mehrerer Clients ermöglicht, aber die Anzahl der 
gleichzeitig aktiven Threads auf eine vorgegebene Zahl be- 
schränkt. 

4. Entwickeln Sie für den File-Server aus Kapitel 4.4 einen 
Client mit grafischer Oberfläche. 



4.10 Aufgaben 
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Bild 4.8: 

File-Client 



5. Aus einer Bücher-Datenbank sollen zu einer vorgegebenen 
Buchnummer Angaben zum Buch (Autor und Titel) über 
SQL abgefragt werden. Nutzen Sie das RPC-Verfahren aus 
Kapitel 4.7 und entwickeln Sie hierzu einen Service mit der 
Methode 

public Buch getBuch (String id) throws Exception 

und einen Client, der diese entfernte Methode aufruft. 

Die Klasse Buch soll die Angaben zum Buch als Attribute mit 
den entsprechenden set- und get-Methoden enthalten. 




5 Implementierung eines HTTP-Servers 



Ziel dieses Kapitels ist es, eine Einführung in das Hypertext 
Transfer Protocol (HTTP) zu geben und einen einfachen Web- 
server zu entwickeln, der in einer erweiterten Fassung dynami- 
sche Webseiten erzeugen kann. 

5.1 Das Protokoll HTTP 

HTTP ist ein Protokoll der Anwenclungsschicht im TCP/IP- 
Schichtenmodell und regelt insbesondere, wie ein Webbrowser 
mit einem Webserver im World Wide Web (WWW) kommuni- 
ziert. HTTP verwendet auf der Transportschicht TCP. 

Damit ein Webbrowser eine Webseite im WWW abrufen kann, 
muss er sie zunächst adressieren. 

Ein Uniform Resource Locator (URL) ist eine standardisierte URL 
Adresse, mit der eine beliebige Ressource (z.B. eine HTML-Seite, 
ein GIF-Bild, eine PDF-Datei, ein Programm) lokalisiert werden 
kann. 

So lokalisiert z.B. 

http : / / www . hs-niederrhein . de/ index . html 

die Website der Hochschule Niederrhein. 

Der URL hat im Allgemeinen den folgenden Aufbau: 
protocol ://host[:port] [/path] [/file] [#section] 

Hierbei sind die eingeklammerten Teile optional. 

Die Angaben bedeuten: 

protocol Protokollname, hier: http 

host Domain-Name oder IP-Adresse des Rechners 

port Portnummer, unter der der Server läuft; die 

standardmäßige Portnummer für einen HTTP-Server 
ist 80 und muss nicht angegeben werden 

path Name eines Verzeichnisses auf dem Server; die Anga- 

be ist relativ zur Wurzel des Webverzeichnisses 

file Name einer Datei in dem spezifizierten 

Verzeichnis 

section verweist auf eine bestimmte Stelle innerhalb 
einer HTML-Seite 
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5 Implementierung eines HTTP-Servers 



Ablauf einer 
HTTP-Transaktion 



HTTP ist 
zustandslos 



Bild 5.1 

Eine HTTP- 
Transaktion 



Die Interaktion zwischen HTTP-Client und HTTP-Server für eine 

Anfrage umfasst die folgenden Schritte: 

1. Der Server wartet auf eine eingehende HTTP -Anfrage. 

2. Der Client erzeugt einen URL http://. . . 

3. Der Client versucht, eine TCP -Verbindung zum Server aufzu- 
bauen. 

4. Der Server akzeptiert den Verbindungswunsch. 

5. Der Client sendet eine Nachricht (HTTP -Anfrage) an den 
Server und fordert die Ressource mit dem spezifizierten URL 
an. 

6. Der Server verarbeitet die Anfrage (z.B. Ausführung einer 
Datenbankabfrage und Generierung einer HTML-Seite mit 
dem Abfrageergebnis). 

7. Der Server sendet eine Rückantwort (HTTP -Antwort) an den 
Client, die die angeforderte Ressource oder eine Fehlermel- 
dung enthält. 

8. Der Client verarbeitet die Antwort. 

9- Der Client uncl/oder der Server schließen die TCP-Verbin- 
dung. 



Der Server hat keine Kenntnis über vorangegangene Anfragen 
desselben Client. Jede Anfrage wird unabhängig von vorherge- 
henden Anfragen bearbeitet. HTTP ist also ein zustandsloses 
Protokoll. 

Für jede HTTP -Anfrage wird bei HTTP 1.0 in der Regel eine 
neue TCP-Verbindung aufgebaut. Enthält z.B. eine angeforderte 
HTML-Seite mehrere Grafiken, so muss jede dieser Grafiken 
separat angefordert werden (jeweils mit Verbindungsaufbau und 
-abbau). 




Webbrowser 



GET /produkte/index.html HTTP/1.1 




HTTP 






HTTP/1.1 200 OK 
Content-Type: text/html 

<html> ... </html> 






Webserver 
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HTTP 1.0 ist im RFC 1945 der IETF spezifiziert (siehe http: HTTP 1.0 
//www. ietf . org/rfc/rfcl945 . txt). 

Die Version HTTP 1.1 unterstützt so genannte persistente Verbin- HTTP 1.1 
düngen. Während die TCP-Verbindung steht, können mehrere 
HTTP -Anfragen über diese Verbindung durchgeführt werden. 

Die Verbindung kann vom Client oder Server abgebaut werden. 

HTTP 1.1 ist im RFC 26l6 der IETF spezifiziert (siehe http: 

/ /www . ietf . org/r f c/r f c2 616. txt) . 



Das folgende Programm zeigt den Inhalt der Nachricht (HTTP- 
Anfrage), die ein Webbrowser an den Webserver schickt. 



import java.io.*; Programm 5-1 

import java.net.*; 

public dass Reporter { 
private int port; 
private String file; 

public Reporter (int port, String file) { 
this.port = port; 
this.file = file; 

} 



public void doWorkO { 

ServerSocket Server = null; 

Socket Client = null; 

InputStream in = null; 

OutputStream out = null; 

try { 

Server = new ServerSocket (port) ; 

Client = Server . accept ( ) ; 

in = dient. getlnputStreamO ; 
out = new FileOutputStream(file) ; 

// Timeout, da die Leseschleife nicht beendet wird, 
dient . setSoTimeout (3000) ; 

int c; 

while ( (c = in.readQ) != -1) { 
out .write (c) ; 



catch (IOException e) { 
System. err .printin (e) ; 

} 

finally { 
try { 

if (in != null) 
in . close ( ) ; 
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if (out != null) { 
out.flush() ; 
out.close () ; 

} 

if (Client != null) 
Client. closeO ; 
if (Server != null) 
Server. close () ; 

} 

catch (IOException e) { } 




public static void main (String [ ] args) { 
if (args.length != 2) { 

System. err. printin ("java Reporter <port> <file>") ; 
System, exit (1) ; 

} 



int port = Integer. parseint (args [0] ) ; 

String file = args[l]; 

new Reporter (port, file) .doWorkO ; 




Das Programm protokolliert die empfangenen Daten in einer 
Datei, deren Name beim Aufruf als Parameter mitgegeben wird, 
und beendet sich nach drei Sekunden selbst. 



Test Aufruf des Programms: 

java -cp build Reporter 50000 log.txt 

Anforderung einer fiktiven HTML-Seite im Webbrowser (hier: 
Firefox): 

http : //localhost : 50000/abc/xyz .html 

Inhalt der Datei log.txt-, 

GET /abc/xyz.html HTTP/1.1 
Host: localhost: 50000 

User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.0; de; ... 

Accept : text/xml, application/xml, application/xhtml+xml, text/html;... 

Accept-Language : de-de , de ; q=0 . 8 , en-us ;q=0.5,en;q=0.3 

Accept-Encoding: gzip, deflate 

Accept-Charset : ISO-8859-1, utf-8; q=0 . 7, *; q=0 . 7 

Keep-Alive: 300 

Connection: keep-alive 



5.1 Das Protokoll HTTP 
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Eine HTTP-Anfrage hat den folgenden Aufbau: HTTP-Anfrage 

• Kopfzeile 

Sie enthält die HTTP-Methode (im Beispiel get), den Namen 
der angeforderten Ressource ohne Protokoll und Domain- 
Namen (im Beispiel /abc/xyz.htmi) und die verwendete Proto- 
kollversion (im Beispiel HTTP/1.1). 

• Anfrageparameter (optional) 

Anfrageparameter liefern dem Server zusätzliche Informa- 
tionen über den Client und seine Anfrage. Jeder Parameter 
benutzt eine eigene Zeile und besteht aus dem Namen, einem 
Doppelpunkt und dem Wert. 

• eine Leerzeile 

• Nutzdatenteil (optional) 

Hier stehen z.B. die in einem Formular eingetragenen Daten 
bei Anwendung der HTTP-Methode post. 

Kopfzeile, Anfrageparameter und Leerzeile enden jeweils mit 
Carriage Return und Linefeed-, \r\n. 



Methode Ressource Version\r\n 
Name: Wert\r\n 



\r\n 



xxxxxxxxxxxxxxxxxxxxxxx 



Kopfzeile 

Anfrageparameter 

Leerzeile 

Nutzdaten 



Bild 52 

Struktur einer 
HTTP-Anfrage 



Im einfachsten Fall reicht eine Anfrage der Form 

GET / index.html HTTP/1.0 

aus, um bereits von einem Webserver verstanden zu werden. 



Die HTTP-Methode spezifiziert die vom Server durchzuführende HTTP-Methoden 
Aktion. 

Wichtige HTTP-Methoden sind: 

• GET 

Diese Methode fordert eine Ressource an. 

• POST 

Diese Methode überträgt Benutzerdaten an den Server. 

• HEAD 

Diese Methode fordert Informationen über die Ressource an; 
die Ressource selbst wird nicht benötigt. 
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Anfragepa ra meter 



MIME 



• PUT 

Diese Methode wird verwendet, um eine Ressource auf dem 
Server abzulegen. 

• DELETE 

Diese Methode wird verwendet, um eine Ressource auf dem 
Server zu löschen. 

put und delete werden aus Sicherheitsgründen von den meisten 
Webservern ignoriert. 



Anfrageparameter können in beliebiger Reihenfolge angegeben 
werden. Groß- und Kleinschreibung wird ignoriert. 

Die gebräuchlichsten Anfrageparameter sind (siehe obiges 
Testbeispiel): 

• Host 

Rechnername und optionale Portnummer des Servers 

• User-Agent 

Kenndaten über den HTTP-Client 

• Connection 

Dieser Parameter wird benutzt, um eine persistente TCP- 
Verbindung anzufordern bzw. zu schließen. 

• Content-Length 

Länge der Daten (in Byte) im Nutzdatenteil 

• Äccept-Language 

Dieser Parameter gibt die vom Client bevorzugte Sprache an. 
Der Server kann dann z.B. eine HTML-Seite, die in mehreren 
Sprachvarianten vorliegt, in der vom Client gewünschten 
Sprache senden. 

• Accept-Encoding 

Mit diesem Parameter gibt der Client an, welche Komprimie- 
rungsalgorithmen er versteht. Der Server kann z.B. große Da- 
teien komprimieren, um die Übertragungszeit zu minimieren. 

• Accept-Charset 

Dieser Parameter gibt die vom Client bevorzugten Zeichen- 
sätze an. 

• Accept 

Dieser Parameter gibt die vom Client akzeptierten Medienty- 
pen an. Die gültigen Parameterwerte sind durch den MIME- 
Standard definiert. 



MIME steht für den Standard Multipurpose Internet Mail 
Extension, der ursprünglich für E-Mails entworfen wurde. 

MIME-Formatangaben werden von HTTP-Clients und HTTP- 
Servern benutzt. Clients nutzen sie, um dem Server mitzuteilen, 
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welche Medientypen sie handhaben können. Server nutzen sie, 
um den Client über den Inhaltstyp der gesendeten Ressource zu 
informieren. 

Die MIME-Formatangabe besteht aus einer Typ- und einer 
Subtypangabe: 

typ/ subtyp 

Der MIME-Standard ist im RFC 1521 der IETF spezifiziert (siehe 

http : //www. ietf . org/rfc/rfc!521 . txt). 



Typ/Subtyp 


Beschreibung und übliche 
Erweiterung 


text/html 


HTML-Datei (*.htm, *.html) 


text/plain 


ASCII-Text (*.txt) 


text/xml 


XML-Datei (*.xml, *.dtd) 


image/gif 


GIF-Bild (*.gif) 


image/jpeg 


JPEG-Bild (*.jpeg, *.jpg) 


image/png 


PNG-Bild (*.png) 


application/ pdf 


PDF-Datei (*.pdf) 


application/octet-stream 


Binärdaten (*.bin, *.exe) 


application/zip 


ZIP-Datei (*.zip) 



Für nicht standardisierte Subtypen wird das Präfix x- benutzt, 
z.B. bezeichnet audio/x-wav Audio-Dateien *.wav. 



Mit der HTTP-Methode post können Benutzerdaten zum Server 
geschickt werden. 

Das folgende Beispiel zeigt ein HTML-Formular, dessen Daten 
durch Betätigen des Buttons "Senden" zum Server (hier Pro- 
gramm 5.1) gesendet werden. 



<html> 

cheadxt it le>POST</t it le></head> 

<body bgcolor=" light grey"> 

<form action="http://localhost:50000/xxx n method= ,, POST"> 
<pre> 

Artikelnurrimer : cinput type="text" name="nr" size="5 ,, /> 
Bezeichnung: cinput type="text" name="bez" size="30 n /> 

Preis: cinput type="text n name= ,, preis" size="10 n /> 

c/pre> 

Beschreibung : cbr/ > 

ctextarea name="beschr n cols= n 60" rows =,, 5 n >c/textarea> 
<p/> 



Beispiele von 
Medientypen 



Daten zum Server 
senden 



HTML-Code des 
Formulars 
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Bild 53: 

Ein Formular 



URL-codiertes 

Format 



<input type="sutmit" value="Senden"/> 
<input type="reset" value=" Zurücksetzen" /> 
</form> 

</body> 

</html> 




Das Programm Reporter protokolliert: 

POST /xxx HTTP/ 1.1 
Host: localhost: 50000 

Content-Length: 112 

nr=4711&bez=Akku-HandstaubsaugerSpreis=15 . 99&beschr=3+Zellen . + 
Kabellos . +Wandhalterung . +Fugend%FCse+und+B%FCrste . 



Die im Formular eingetragenen Daten werden im URL-codierten 
Format (application/x-www-fom-urlencoded) Übertragen. 

Die im Formular definierten Variablennamen (im Beispiel: nr, 
bez, preis, beseht •) sind mit den vom Benutzer eingegebenen 
Werten verknüpft. Variable und Wert werden jeweils durch ein 
Gleichheitszeichen voneinander getrennt. Die einzelnen Variab- 
le/Wert-Paare sind durch das Zeichen & getrennt. Bestimmte 
Sonderzeichen, die eine spezielle Bedeutung haben (z.B. = und 
s), werden ersetzt durch ein Prozentzeichen, gefolgt vom ASCII- 
Wert des Zeichens als Hexadezimalwert. Leerzeichen werden 
durch + ersetzt. 

Formulare können auch die GET-Methode nutzen, um Daten zu 
übertragen. Die URL-codierten Daten werden nach einem Frage- 
zeichen ? an den URL angehängt. Im HTML-Code des obigen 
Formulars muss nur post durch get ersetzt werden. Die Kopfzeile 
der HTTP -Anfrage hat dann das folgende Aussehen: 

GET /xxx?nr=4711&bez=Akku-Handstaubsauger&preis=15. 99&beschr= 

3+Zellen . +Kabellos . +Wandhalterung . +Fugend%FCse+und+B%FCrste . HTTP/ 1 . 1 
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Die so codierte Anfragezeichenkette nach dem Fragezeichen Query String 
wird auch als Query String bezeichnet. 



Eine HTTP-Antwort hat den folgenden Aufbau: HTTP-Antwort 

• Kopfzeile 

Sie besteht aus der Protokollversion, dem Status-Code und ei- 
ner optionalen Status-Meldung. 

• Antwortparameter (optional) 

Antwortparameter liefern dem Client zusätzliche Infor- 
mationen über den Server und die Antwort. 

• eine Leerzeile 

• Nutzdatenteil (optional) 

Dieser enthält die angeforderte Ressource. 



Version Code Meldung\r\n 



Name: Wert\r\n 



\r\n 



xxxxxxxxxxxxxxxxxxxxxxx 



Kopfzeile 

Antwortparameter 

Leerzeile 

Nutzdaten 



Bild 5A: 

Struktur einer 
HTTP-Antwort 



Beispiel: 

HTTP/1.1 200 OK 

Date: Mon, 09 Äug 2005 08:20:30 GMT 
Server : Apache/ 1.3.31 (Win32 ) 
Content -Type : text/html 
Content -Length: 249 

<html> . . . </html> 



Der Status-Code teilt dem Client mit, wie die gewünschte Aktion Status-Code 
vom Server ausgeführt wurde. 

Die Status-Codes sind wie folgt gruppiert: 



100 - 199 


Informative Meldungen 


200 - 299 


Die Anfrage war erfolgreich 


300 - 399 


Die Anfrage wurde weitergeleitet 


400 - 499 


Die Anfrage war fehlerhaft 



Server-Fehler 



500 - 599 
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Einige Antwort- 
parameter 



Programm 5-2 



Codes, die in den folgenden Programmbeispielen genutzt wer- 
den, sind: 

200 OK 

400 Bad Request 

404 Not Found 

500 Internal Server Error 

501 Not Implemented 



Gebräuchliche Antwortparameter sind: 

• Date 

Aktuelles Datum des Servers zum Zeitpunkt der Beant- 
wortung der Anfrage 

• Server 

Kenndaten über den HTTP-Server 

• Content -Type 
MIME-Format der Nutzdaten 

• Content-Length 

Länge der Daten (in Byte) im Nutzdatenteil. Werden Websei- 
ten dynamisch erzeugt, ist die Länge oft nicht bekannt, wes- 
halb dieser Parameter dann weggelassen wird. 



5.2 Ein einfacher File-Server 

Das folgende Programm ist ein HTTP-Server, der als einzigen 
Dienst nach Verbindungsaufnahme mit einem Client immer die- 
selbe Datei sendet. Zu diesem Zweck muss er also die HTTP- 
Anfrage des Client gar nicht auswerten. 

Der Server wird mit dem Dateinamen als Parameter aufgerufen. 
Anhand der Dateiendung wird der passende MIME-Typ festge- 
legt. Die HTTP -Antwort besteht aus der Kopfzeile mit Status- 
Code 200, den beiden Antwortparametern Content -Type und con- 
tent-Length, einer Leerzeile und dem Inhalt der Datei. 



import java.io.*; 
import java.net.*; 

public dass SingleFileServer { 
private int port; 
private File file; 
private String type; 

public SingleFileServer (int port, File file) { 
this.port = port; 
this.file = file; 



5.2 Ein einfacher File-Server 



159 



// MIME-Typ festlegen 

String f ilename = f ile . getName ( ) ; 

if (filename.endsWithC.html") || filename.endsWithC.htm")) 
type = "text/html"; 

eise if (filename.endsWithC.txt") || f ilename. endsWith (". java") ) 
type = "text/plain" ; 
eise if ( f ilename . endsWith ( " . gif " ) ) 
type = "image/gif"; 
eise if (f ilename. endsWith (" . jpg") ) 
type = "image/jpeg"; 
eise if ( f ilename. endsWith (" .png") ) 
type = "image/png"; 
eise if (f ilename. endsWith (" .pdf") ) 
type = "application/pdf"; 
eise 

type = "application/octet-stream"; 



public void startServer ( ) { 
try { 

ServerSocket Server = new ServerSocket (port) ; 

InetAddress addr = InetAddress.getLocalHost () ; 
System. out .printin ("SingleFileServer auf " + 

addr . getHostName ( ) + "/" + addr.getHostAddress () + 
" : " + port + " gestartet ..."); 

while (true) ( 

Socket Client = Server. accept () ; 
new SingleFilelhread (Client) . Start () ; 



catch (IOException e) { 
System. err .printin (e) ; 

) 



private dass SingleFilelhread extends Thread { 
private Socket dient; 

public SingleFilelhread (Socket dient) { 
this. Client = dient; 

> 



public void run() ( 

String clientAddr = dient. getlnetAddress () .getHostAddress () ; 
int clientPort = dient. getPort () ; 

System, out ,println( "Verbindung zu " + 

clientAddr + + clientPort + " aufgebaut"); 

FilelnputStream is = null; 
try ( 

BufferedReader in = new Buf feredReader ( 

new InputStreamReader (dient. getlnputStreamf) ) ) ; 

String line; 

while ((line = in . readLine ( ) ) != null && lline.eguals ("") ) { } 
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is = new FilelnputStream(file) ; 

BufferedOutputStream out = new BufferedOutputStream( 
Client .getOutputStream () ) ; 

String header = "HTTP/1.0 200 OK\r\n" + 
"Content-Type: " + type + "\r\n" + 

"Content-Length : " + f ile . length ( ) + "\r\n\r\n"; 

out . wr ite (header . getBytes ( ) ) ; 

int c; 

while ( (c = is.readO) != -1) { 
out .write (c) ; 

} 



out . f lush ( ) ; 
out . close ( ) ; 
in.close () ; 

} 

catch (IOException e) { 

System. err .printin (e) ; 

} 

finally { 
try { 

if (Client != null) 

Client . close ( ) ; 
if (is != null) 
is . close ( ) ; 

} 

catch (IOException e) ( } 

System.out.println ("Verbindung zu " + 

clientAddr + + clientPort + " abgebaut"); 

} 

} 

} 



public static void main (String [ ] args) { 
if (args. length != 2) { 

System. err .printin ("java SingleFileServer <port> <file>"); 
System. exit (1) ; 

} 



int port = Integer .parseint (args [0] ) ; 

File file = new File (args [1] ) ; 
if ( ! file . isFile () ) { 

System. err. printin ( 

"Datei + args[l] + ist nicht vorhanden"); 
System. exit (1) ; 

} 



new SingleFileServer (port, file) . startServer () ; 
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Aufruf des Servers: 

java -cp build SingleFileServer 50000 src/SingleFileServer . java 



Eingabe im Webbrowser: 
http : //localhost : 50000/ 



5.3 Ein HTTP-Server für SQL-Abfragen 

Wir stellen zunächst Methoden vor, die eine Zeichenkette in ein 
URL-codiertes Format transformieren bzw. eine so codierte Zei- 
chenkette wieder decodieren können. 



Die Klasse java. net. uRLEncoder enthält eine Klassenmethode zur 
URL-Codierung einer Zeichenkette. 

static String encode (String s, String enc) 
throws UnsupportedEncodingException 

wandelt Zeichen aus s in das URL-codierte Format "x-www-form- 
uriencoded" um, wobei für die Zeichenkodierung das Codierungs- 
schema enc zugrunde gelegt wird (z.B. iso-8859-i). 

Wird das Codierungsschema enc nicht unterstützt, so löst diese 
Methode eine Ausnahme vom Typ java. io. UnsupportedEncoding- 
Exception (Subklasse von ioException) aus. 



Die Klasse java. net. URLDecoder dient der Decodierung einer URL- 
codierten Zeichenkette. 

static String decode (String s, String enc) 
throws UnsupportedEncodingException 

decodiert eine URL-codierte Zeichenkette, wobei für die Zei- 
chenkodierung das Codierungsschema enc zu Grunde gelegt 
wird. 



Das zu entwickelnde Programm sgiserver ermöglicht es, beliebige 
SQL-Anfragen (Abfragen und Änderungen) an eine Datenbank 
über den Webbrowser zu schicken. 

Dieser spezielle HTTP-Server 

• sendet ein Eingabeformular zur Erfassung des SQL-Befehls an 
den Webbrowser, 

• analysiert den SQL-Befehl und führt ihn über JDBC aus, 

• sendet evtl. SQL-Fehlermeldungen und 

• sendet das Abfrageergebnis bzw. Informationen über Daten- 
bankänderungen an den Webbrowser. 



Test 



URLEncoder 



URLDecoder 



Programm 53 
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5 Implementierung eines HTTP-Servers 



SqlServer 



import java.io.*; 
inport java.net.*; 
import java.sql.*; 
import java.util.*; 

public dass SqlServer { 

private static final int MAX_ROWS = 1000; 
private static final int MAX_LENGTH = 1000; 
private int port; 
private Properties prop; 

public SqlServer (int port) { 
this.port = port; 

} 



public void Startserver () { 
try { 

// Properties einiesen 
prop = new Properties ( ) ; 

FilelnputStream in = new FilelnputStream ( 

"dbconnect. properties") ; 
prop.load(in) ; 
in.closeO ; 

// JDBC-Treiber laden 

Class . f orName (prop . getProperty ( "driver " ) ) ; 

ServerSocket Server = new ServerSocket (port) ; 
InetAddress addr = InetAddress . getLocalHost ( ) ; 
System. out .printin ("SqlServer auf " + 

addr . getHostName ( ) + "/" + addr . getHostAddress ( ) + 
" : " + port + " gestartet ..."); 

while (true) { 

Socket Client = Server . accept ( ) ; 
new SqlThread (dient, prop) .Start () ; 



catch (Exception e) { 
System, err .printin (e) ; 
System. exit (1) ; 




private class SqlThread extends Thread { 
private Socket dient; 
private Properties prop; 
private Connection con; 
private BufferedReader in; 
private PrintWriter out; 

public SqlThread (Socket dient, Properties prop) { 
this. Client = dient; 
this.prop = prop; 

} 
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public void run() { 

String clientAddr = dient. getlnetAddress () .getHostAddress () ; 
int clientPort = dient. getPort () ; 

System. out .print ln ("Verbindung zu " + 

clientAddr + + clientPort + " aufgebaut") ; 

try { 

// Verbindung zur Datenbank hersteilen 

con = DriverManager . get Connection (prop . getProperty ( "url " ) , 
prop . getProperty ( "user" ) , prop . getProperty ( "password" ) ) ; 

in = new Buf feredReader (new InputStreamReader ( 
dient. getlnputStreamO ) ) ; 

out = new PrintWriter (dient . getOutputStream ( ) , true) ; 

// HTTP-Request analysieren 
String sql = readRequest () ; 

// HTML-Formular senden 

sendForm ( sql ) ; 

// SQL-Befehl aus führen 
if (sql != null) 

execute(sql) ; 

in.close () ; 
out. dose () ; 

} 

catch (Exception e) { 

Sy stem . err . printin (e ) ; 

} 

finally { 
try { 

if (con != null) 
con.closeO ; 
if (dient != null) 
dient . close ( ) ; 

} 

catch (Exception e) { } 

Sy stem. out. print ln ("Verbindung zu " + 

clientAddr + " :" + clientPort + " abgebaut"); 




// Der Quellcode der folgenden Methoden ist weiter unten 
// abgedruckt: 

private String readRequest ( ) throws IOException { ... } 
private void sendForm (String sql) throws IOException { ... } 
private void execute (String sql) throws SQLException { . . . } 
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public static void main (String [ ] args) { 
if (args.length != 1) { 

System. err. printin ("java SqlServer <port>") ; 
System. exit (1) ; 

} 



int port = Integer .parseint (args [0] ) ; 
new SqlServer (port) .Startserver () ; 




Datenbankspezifische Angaben (JDBC-Treiber, URL der Daten- 
bank, User und Passwort) sind in der Datei dbconnect. properties 
zusammengefasst und werden zu Beginn als Properties eingele- 
sen. 

Innerhalb der run-Methode der inneren Klasse sqiThread erfolgt 
die Interaktion mit dem Client. 

Zunächst wird die Verbindung zur Datenbank hergestellt. Die 
Methode readRequest analysiert dann die HTTP -Anfrage und liefert 
den vom Benutzer eingegebenen SQL-Befehl. 

Die Rückantwort des Servers enthält eine HTML-Seite, die im 
oberen Teil ein Formular zur Eingabe eines SQL-Befehls und im 
unteren Teil das Ergebnis der letzten Anfrage enthält. 

Die Methode sendFom sendet das Formular mit dem zuletzt ein- 
gegebenen SQL-Befehl an den Client zurück. 

Die Methode execute führt den SQL-Befehl aus und sendet das 
Ergebnis bzw. eine Fehlermeldung. Damit ist dann die HTML- 
Seite vollständig erzeugt. 

Zu Beginn der Sitzung wird nur ein leeres Formular an den 
Client geschickt. 



Die Methode 
readRequest 



private String readRequest ( ) throws IOException ( 

String line = in . readLine ( ) ; 
if (line = null) 

throw new IOException ("Kein Input"); 

// SQL-Befehle werden über ein Formular mittels POST gesendet 
if ( ! line . startsWith ( "POST" ) ) 
retum null; 

// Bis zur Leerzeile lesen und Content-Length ermitteln 
int length = 0; 

while ((line = in . readLine () ) != null && ! line . equals ( " " ) ) { 
line = line . toLowerCase ( ) ; 
if (line . startsWith ( "content-length" ) ) 

length = Integer. parseint (line. substring (16) ) ; 
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// Zeichen nach der Leerzeile einiesen 
int c; 

StringBuilder sb = new StringBuilder () ; 
for (int i = 0; i < length; i++) { 
c = in . read ( ) ; 
if (c = -1) 
break; 

sb . append ( (char ) c) ; 

} 



// Decodierung der "x-www-form-urlencoded" Zeichen 
String query = sb.toStringO ; 
int i = query. indexOf ('=') ; 
if (i < 0) 
return null; 

return URLDecoder .ctecode (query. substring (i + 1), "ISO-8859-1") ; 



Es wird nur die HTTP-Methode post zugelassen. Somit muss der 
Anfrageparameter Content-Length vorhanden sein. Die Länge wird 
extrahiert und in eine Zahl vom Typ int konvertiert. Zeichenwei- 
se werden nun die Daten des Nutzdatenteils in einen Puffer ü- 
bertragen. Die Daten nach dem Gleichheitszeichen = werden 
extrahiert und, da sie URL-codiert sind, decodiert. 



private void sendForm( String sql) throws IOException { 
out .print ("HTTP/1.0 200 OK\r\n" + 

"Content-Type: text/html\r\n\r\n") ; 
out .print ("<html><head><title>SQL</title></head>") ; 
out. print ("<body bgcolor='lightgrey'>") ; 
out. print ("<b>" + prop.getProperty ("url") + "</bXp/>"); 
out. print ("<form method= ' POST ' >" ) ; 

out. print ("<textarea cols='80' rows='4' name='sql'>") ; 

if (sql != null) 
out .print (sql) ; 

out. print ("</textareaxp/>") ; 

out . print ("<input type= ' submit ' value='Senden'Xp/>") ; 
out. print ("</form>") ; 

if (sql = null) 

out .print ("</bodyx/htrnl>") ; 

out.flush() ; 

) 



Ist der Parameter sqi gleich null (d.h. es wurden keine Benutzer- 
daten gesendet), so erzeugt diese Methode die komplette HTTP- 
Antwort: ein HTML-Formular. Andernfalls generiert sie nur den 
ersten Teil der Antwort: ein Formular mit dem zuletzt gesendeten 
SQL-Befehl. 



Die Methode 
sendForm 
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Die Methode 
execute 



private void execute (String sql) throws SQLException { 
try ( 

Statement stmt = con . createStatement ( ) ; 

if (! stmt .execute (sql) ) { 
out. printin ( stmt. getüpdat eCount () + " Zeile(n)"); 
stmt.closeO ; 
retum; 

} 



// Ausgabe der Zeilen in Form einer HTML-Tabelle 



ResultSet rs = stmt.getResultSet () ; 
ResultSetMataData rm = rs.getMetaDataO ; 
int n = rm.getColumnCount () ; 

String [] align = new String [n] ; 



out .printin ( "<table bgcolor= ' white ' 
"border= ' 1 ' cellpadding= ' 5 ' > " ) ; 



// Spaltenüberschriften der Tabelle 

out .printin ( "<tr>" ) ; 

for (int i = 1; i <= n; i++) ( 

// Zahlen werden rechtsbündig ausgerichtet 
if (rm.getColumnType (i) = Types . TINYINT | 
rm.getColumnType (i) = Types . SMALLINT | | 
rm . getColumnType ( i ) 
rm . getColumnType ( i ) 
rm . getColumnType ( i ) 
rm . getColumnType ( i ) 
rm . getColumnType ( i ) 
rm . getColumnType ( i ) 
rm . getColumnType ( i ) 



= Types . INTEGER | | 
= Types. BIGINT | 

= Types. REAL | 

= Types. FLOAT | | 

= Types. DOUBLE | 

= Types. NUMERIC | | 
= Types. DECIMAL) 



align[i-l] = "right"; 
eise 

align[i-l] = "left"; 



out.println("<th align='" + align [i— 1] + 
rm.getColumnName (i) + "</th>"); 



out .printin ("</tr>") ; 

// Tabellenzeilen 

// Anzahl Zeilen und Länge eines Spaltenwerts sind begrenzt 
int count = 0; 
while (rs.nextO) { 

if (f+count > MAX_ROWS) 
break; 



out . printin ( "<tr>" ) ; 
for (int i = 1; i <= n; i++) { 
String s = rs.getString(i) ; 
if (rs.wasNull () ) { 
s = "[NULL]"; 
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eise ( 

if (s.lengtho > MAX_LENGTH) { 
s = s. substring (0, MAX_LENGTH) + 



out .printin ("<td valign='top' align='" + 
align[i-l] + + s + "</td>"); 

} 

out.println("</tr>") ; 



out .printin ( "</table>" ) ; 
if (count > MAX_ROWS) 

out. printin ("Es werden maximal " + MAX_ROWS + 
" Zeilen angezeigt . " ) ; 

rs . close ( ) ; 
stmt.closeO ; 

} 

catch (SQLException e) { 
out .printin (e) ; 

} 

finally < 

out .printin ( "</bodyx/html>" ) ; 



} 



Der SQL-Befehl wird ausgeführt (Details zur Handhabung des 
JDBC-API findet man im Kapitel 2). Das Ergebnis der Datenbank- 
änderung bzw. Abfrage ergibt den zweiten Teil der Antwort an 
den Client. Das Abfrageergebnis wird in einer HTML-Tabelle 
dargestellt. Um die an den Browser zu übertragende Datenmen- 
ge zu begrenzen, werden maximal max_rows Zeilen und je Spal- 
tenwert einer Zeile maximal mrx_length Zeichen gesendet. 



j db c : my s ql: //lo c alho st/bue eher 



select isbn, autor, titel from buch where titel like ' %Nickleby%‘ 



Senden | 



isbn 


autor titel 


, 3-257-20998-3 


Dickens, Charles Nikolas Niekleby 


3-458-33004-6 


Dickens, Charles 


Nikolaus Niekleby 


3-538-06658-2 


Dickens, Charles 


Nicholas Niekleby 


3-538-06982-4 


Dickens, Charles Nicholas Niekleby 



Bild 5.5 

SQL-Abfrage 
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5 Implementierung eines HTTP-Servers 



Programm 5-4 



alias. properties 



java.policy 



5.4 Ein einfacher Webserver 

Im Folgenden entwickeln wir einen einfachen Webserver, der 
nur die HTTP -Methode get versteht und keine Query Strings 
akzeptiert. Das Programm wird mit zwei Parametern aufgerufen: 

• Portnummer port und 

• Name des so genannten Root-Verzeichnisses dir. 

dir ist die Wurzel des Webverzeichnisses, das alle abrufbaren 
Ressourcen enthält. 



Der Server unterstützt auch so genannte virtuelle Verzeichnisse. 
In der Datei alias .properties sind zu diesem Zweck Zuordnungen 
in folgender Form festgelegt: 

logischer Name = physischer Name 



Beispiele: 

Ist das Wurzelverzeichnis Aweb, so referenziert der URL http: 
//localhost:50000/index.html die Datei .\web\index.html auf dem 
Server. 



Die Datei alias. properties enthält die Zeile: 

demo = . /web2 

Der URL http: //iocaihost:50000/demo/index. html referenziert die 
Datei . \web2\index.html auf dem Server. 



Um zu verhindern, dass Ressourcen, die außerhalb der vorgege- 
benen Verzeichnisse liegen, vom Browser abgerufen werden, 
Z.B. durch http://localhost:50000/. ./abc.txt, wird in der main- 
Methode ein Security Manager installiert: 

System. setSecurityManager (new SecurityManager ( ) ) ; 



Die nötigen Zugriffsrechte werden in der Datei java.policy fest- 
gelegt: 

grant { 

permission java . net . SocketPermission " * : 1024-" , "connect, accept " ; 
permission java. lang. RuntimePermission "shutdownHooks"; 
permission java. io. FilePermission "alias. properties", "read"; 

// Nur Dateien aus dem hier angegebenen Verzeichnis 
// (inkl. Unterverzeichnissen) können gelesen werden. 



permission java. io. FilePermission "web\\-", "read"; 
permission java. io. FilePermission "web2\\-", "read"; 
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Der Webserver protokolliert jeweils die erste Zeile einer HTTP- 
Anfrage und kann durch Eingabe der Tastenfolge strg+c beendet 
werden. 

Beispiel (Aufruf in einer Zeile): 

java -Djava. security. policy=java.policy -cp build 
Webserver. MiniWebServer 50000 web 

Ausgabe: 

MiniWebServer auf pc0806/10. 108. 105. 96:50000 gestartet ... 

Wed Aug 30 10:14:19 CEST 2006: 10.108.105.95:3030 GET / 

Wed Äug 30 10:14:19 CEST 2006: 10.108.105.95:3031 GET /java. gif 

Wed Äug 30 10:14:22 CEST 2006: MiniWebServer gestoppt 

Bild 5.6 zeigt die in diesem Programm verwendeten Klassen und 
ihre Abhängigkeiten. 



Bild 5.6 

Die verwendeten 
Klassen 



SL 



HttpConnection 












HttpException 


«— HttpRequest HttpResponse HttpGetHandler 


A A 







MiniWebServer 



-> = benutzt 



Übersicht über die Funktionalität der Klassen: 



MiniWebServer 


Server starten 
Verbindungen akzeptieren 
Server herunterfahren 


HttpConnection 


Anfrage bearbeiten 
Ausnahmen behandeln 


HttpException 


Ausnahme, über die der Webbrowser infor- 
miert wird 


HttpRequest 


Anfrage einiesen und analysieren 


HttpResponse 


Kopfzeile und Antwortparameter 
zusammenstellen und senden 


HttpGetHandler 


angeforderte Ressource lokalisieren und sen- 
den 
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MiniWebServer 



package Webserver; 

import java.io.*; 
import java.net.*; 
inport java.util.*; 

public dass MiniWebServer < 
private int port; 
private String dir; 
private ServerSocket Server; 

public MiniWebServer (int port, String dir) < 
this.port = port; 
this.dir = dir; 

} 



public void Startserver () { 

System. setSecurityManager (new SecurityManager ( ) ) ; 

// ShutdownHook registrieren 

Runtime . getRuntime () . add ShutdownHook (new ThreadO { 
public void run() { 
terminate ( ) ; 



}); 

try { 

FilelnputStream in = new FileInputStream( "alias. properties") ; 
Properties alias = new Properties ( ) ; 
alias. load (in) ; 
in.closeO ; 

Server = new ServerSocket (port) ; 

InetAddress addr = InetAddress . getLocalHost ( ) ; 

System. out .printin ("MiniWebServer auf " + 

addr . getHostName ( ) + "/" + addr . getHostAddress ( ) + 

" : " + port + " gestartet ..."); 

while (true) { 

Socket Client = Server . accept ( ) ; 

new HttpConnection (dient, dir, alias) .Start () ; 



catch (SocketException e) { } 
catch (IOException e) { 

System. err. printin (new Datei) + " MiniWebServer: " + e) ; 

} 



// ServerSocket schließen 
public void terminate () { 
try { 

if (Server != null) 
Server. closeO ; 
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catch (IOException e) { } 

System, out. printin (new DateO + MiniWebServer gestoppt"); 



public static void main (String [] args) { 
if (args.length != 2) { 

System. err .printin ("java MiniWebServer <port> <dir>") ; 
System. exit (1) ; 

) 



int port = Integer .parseint (args [0] ) ; 

String dir = args[l]; 

new MiniWebServer (port, dir) .startServer () ; 




Die Methode Startserver registriert einen Shutdoumhook, der den 
Server-Socket mit Hilfe der Methode terminate bei der Terminie- 
rung des Programms (z.B. durch Abbruch mit strg+c) schließt. 
Hiermit wird der Einsatz eines Shutdownhooks demonstriert, er 
ist für die Lauffähigkeit des Programms in diesem Fall jedoch 
nicht erforderlich. 

Wird der Server-Socket geschlossen, während noch die server- 
socket-Methode accept auf einen Verbindungswunsch wartet, so 
wird eine socketException ausgelöst. 



package Webserver; 

import java. io.*; 
import java.net.*; 
import java.util.*; 

public dass HttpConnection extends Thread { 
private Socket dient; 
private String dir; 
private Properties alias; 
private BufferedReader in; 
private OutputStream out; 
private HttpRequest request; 
private HttpResponse response; 



HttpConnection 



public HttpConnection (Socket dient, String dir, Properties alias) { 
this. Client = dient; 
this.dir = dir; 
this. alias = alias; 



public void run() { 
try { 

in = new BufferedReader (new InputStreamReader ( 
dient. getlnputStream () , "ISO-8859-1") ) ; 
out = Client . getOutputStream ( ) ; 



request = new HttpRequest (in) ; 
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response = new HttpResponse (out) ; 

request .getRequest () ; 

String method = request. getMethodQ ; 

String url = request. getUKLO ; 

String clientAddr = dient. getlnetAddress () . getHostAddress ( ) ; 
int clientPort = dient. getPort () ; 

System, out .printin (new DateO + ": " + clientAddr + + 

clientPort + " " + method + " " + url) ; 

// printHeaders () ; 

if ( (method. equals ("GET") ) 
throw new HttpException! 

"Nur die GET-Methode ist zulässig", 501); 

// GET-Request verarbeiten 

new HttpGetHandler (dir, alias, request, response) .process () ; 

} 

catch (HttpException e) { 
try { 

handeException (e) ; 

} 

catch (IOException ex) { } 

} 

catch (IOException e) { 

System. err .printin (new Datei) + " HttpConnection : " + e) ; 

} 

finally { 
try { 

if (Client != null) 

Client. closeO ; 

} 

catch (IOException e) { } 




private void printHeaders ( ) { 

Hashtable<String, String> headers = request. getHeaders () ; 
Enumeration<String> e = headers. keys () ; 
while (e.hasMoreElements () ) { 

String key = e.nextElement () ; 

System. out .printin ("\t" + key + ": " + headers . get (key) ) ; 




private void handeException (HttpException e) throws IOException ( 
int Status = e.getStatus () ; 
response. printstat us (Status) ; 
response. addHeader ("Content-Type", "text/html") ; 
response. printHeaders () ; 

String statusMsg = Status + " " + response. getStatusText (Status) ; 
StringBuilder msg = new StringBuilder () ; 

msg.append("<html><head><title>" + statusMsg + "</titlex/head>") ; 
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msg.append("<bodyxhl>" + statusMsg + "</hl>" + e . getMessage ( ) 
+ "</bodyx/html>") ; 

out .write (msg.toStringO .getBytes ("ISO-8859-1") ) ; 
out . f lush ( ) ; 




Ein HttpRequest- und ein HttpResponse-Objekt werden mit Hilfe des 
Socket-Eingabe- bzw. -Ausgabestroms erzeugt. 

Da die Daten der HTTP -Anfrage gemäß "ISO Latin Alphabet 
No. 1" codiert sind, wird für den inputstreamReader der Zeichen- 
satz iso-8859-i zugrunde gelegt. 

Die HTTP-Anfrage wird eingelesen. Die HTTP -Methode und der 
URL der Ressource werden ermittelt und protokolliert. Andere 
Methoden als get führen zur Auslösung einer HttpException. Mit 
Hilfe eines HttpGetHandier-Objekts wird die Anfrage bearbeitet. 

Evtl. Ausnahmen vom Typ HttpException werden von der Methode 
handieException behandelt. Zeichenketten werden für die Ausgabe 
in Bytes gemäß iso-8859-i gewandelt. 



package Webserver; 

public dass HttpException extends Exception { 
private int Status; 

public HttpException (String msg, int Status) { 
super (msg) ; 
this. Status = Status; 

} 



HttpException 



public int getStatus ( ) { 
return Status; 

1 



package Webserver; 

import java.io.*; 
import java.util.*; 

public dass HttpRequest < 
private BufferedReader in; 
private String method = 
private String url = 
private String path = 
private String query = 

private HashtablekString, String> headers; 



HttpRequest 
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public HttpRequest (BufferedReader in) ( 
this.in = in; 

headers = new Hashtable<String, String> ( ) ; 

} 



public String getMethodO { 
retum method; 

} 



public String getURLO { 
retum url; 

} 



public String getPathQ { 
retum path; 

} 



public String getQueryO ( 
retum guery; 

} 



public HashtablekString, String> getHeaders ( ) < 
retum headers; 

} 



public String getHeader (String key) { 
retum headers . get (key) ; 

} 



public void getRequest ( ) throws HttpException ( 
try { 

// Erste Zeile (Request-Line) analysieren 
String line = in . readLine ( ) ; 
if (line = null) 
retum; 

StringTokenizer st = new StringTokenizer (line) ; 
method = st. next Token () ; 
url = st. next Token () ; 

// Path und Query String speichern 
path = url; 

int idx = url . indexOf ('?'); 
if (idx >= 0) { 

path = url. substring (0, idx); 
if (idx + 1 < url.length() ) ( 
query = url. substring (idx + 1); 




// Header analysieren und speichern 

while ((line = in. readLine () ) != null && line . length ( ) >0) { 
int i = line . indexOf (':'); 
if (i > 0) { 

String key = line. substring (0, i) ; 

String value = line. substring (i + 2); 
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if (key != null && value != null) { 
headers .put (key.toLowerCase () , value) ; 



catch (IOException e) { 

throw new HttpException ( "Fehler beim Lesen des Request", 500); 

} 

catch (Exception e) { 

throw new HttpException ( "Fehler beim Parsen des Request", 400); 



} 



Die Methode getRequest liest die Zeilen der HTTP -Anfrage bis zur 
Leerzeile, ermittelt die HTTP -Methode, den URL, den Ressour- 
cenpfad und evtl, den Query String. Anfrageparametername und 
-wert werden in einer Hashtable gespeichert. Diese verschiede- 
nen Bestandteile können über get-Methoden abgefragt werden. 



package Webserver; 

import java.io.*; 
import java.util.*; 

public dass HttpResponse { 

private Hashtable<String, String> headers; 
private OutputStream out; 

public HttpResponse (OutputStream out) { 
this.out = out; 

headers = new Hashtable<String, String> ( ) ; 

} 



public OutputStream getOutputStream ( ) { 
retum out; 

} 



public void addHeader (String key, String value) { 
if (key != null && value != null) { 
headers .put (key, value) ; 

} 



public String getStatusText (int Status) { 
String txt; 
switch (Status) { 

case 200: txt = "OK"; 

break; 

case 400: txt = "Bad Request"; 

break; 

case 404: txt = 

break; 



HttpResponse 



'Not Found"; 
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case 500: txt = "Internal Server Error"; 

break; 

case 501: txt = "Not Implemented"; 

break; 

default: txt = 

} 

retum txt; 

} 



public void printStatus (int Status) throws IOException < 

String line = "HTIP/1.0 " + Status + " " + getStatusText (Status) 
+ "\r\n"; 

out.write(line.getBytes("ISO-8859-l") ) ; 
out.flush() ; 



public void printHeaders ( ) throws IOException ( 
Enumeration<String> e = headers.keys () ; 
while (e.hasMoreElements () ) { 

String key = e.nextElement () ; 

String line = key + ": " + headers . get (key) + "\r\n"; 
out.write (line.getBytes ("ISO-8859-1") ) ; 



String line = "\r\n"; 
out.write(line.getBytes("ISO-8859-l") ) ; 
out.flush() ; 




Antwortparameter werden in einer Hashtable verwaltet und kön- 
nen mit addHeader aufgenommen werden. printStatus schreibt die 
Kopfzeile und printHeaders die Antwortparameter in den Ausga- 
bestrom. 



HttpGetHandler 



package Webserver; 

inport java.io.*; 
import java.net.*; 
import java.util.*; 



public dass HttpGetHandler { 
private String dir; 
private Properties alias; 
private HttpRequest request; 
private HttpResponse response; 



public HttpGetHandler (String dir, Properties alias, 

HttpRequest request, HttpResponse response) { 



this.dir = dir; 
this. alias = alias; 
this. request = request; 
this . response = response; 
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public void process ( ) throws IOException, HttpException { 

String url = request.getURLO ; 

String path = url; 

int idx = url . indexOf ('?'); 
if (idx >= 0) 

throw new HttpException ( 

"Query String wird nicht unterstützt", 501) ; 

if (path . endsWith ("/")) 

path = path + "index.html"; 

String filename = getFilename (path) ; 

File file = new File ( filename) ; 

FilelnputStream fis = null; 
try { 

fis = new FilelnputStream ( file) ; 

String type = URLConnection.getFileNameMapO .getContentTypeFor ( 
filename) ; 
if (type = null) { 

type = "application/octet-stream"; 

> 

response. addHeader ("Content-Type", type) ; 
response . addHeader ( "Content-Length" , 

String.valueOf (file.lengthQ ) ) ; 
response. printStatus (200) ; 
response. printHeaders () ; 

OutputStream out = response. getOutputStream ( ) ; 
byte data[] = new byte[1024]; 
int ent; 

while ((ent = f is . read (data) ) != -1) { 
out .write (data, 0, ent); 

) 

out . f lush ( ) ; 

> 

catch (SecurityException e) { 

throw new HttpException (e.getMessageQ , 400); 

> 

catch (FileNotFoundException e) { 

throw new HttpException (e . getMessage ( ) , 404); 

) 

finally ( 
try ( 

if (fis != null) 
fis . close ( ) ; 

) 

catch (IOException e) { } 



} 

private String getFilename (String path) { 
int idx = path. indexOf ("/", 1); 



String filename; 
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if (idx > 0) { 

String key = path. substring (1, idx) ; 
String value = alias. getProperty (key) ; 
if (value = null) 

filename = dir + path; 
eise 

filename = value + path . substring (idx) ; 



eise 

filename = dir + path; 
retum filename; 

} 

} 



process führt die Aktion get aus. Query Strings werden nicht un- 
terstützt. Endet der Name der Ressource mit einem Schrägstrich 
/, so wird standardmäßig nach der HTML-Datei index.html in dem 
so bezeichneten Verzeichnis gesucht. Die einzigen Antwortpara- 
meter sind Content-Type und Content-Length. 

Die Methode getFiiename ennittelt den Dateinamen der angefor- 
derten Ressource. Hierbei werden auch evtl, angegebene virtuel- 
le Verzeichnisse (wie eingangs beschrieben) berücksichtigt. 

Der MIME-Typ der Ressource wird mit der Methode 

URI£onnect ion . getFi leNameMap ( ) . getContentTypeFor (...) 

ermittelt. 

Die abstrakte Klasse java.net.uRLConnection ist die Superklasse 
derjenigen Klassen, die eine Netzverbindung zu einer durch den 
URL adressierten Ressource repräsentieren. 

static FileNameMap getFileNameMap ( ) 

lädt die Tabelle der MIME-Typen aus einer Datei ( lib\content - 
types .properties in dem durch die System Property "java.home" 
bezeichneten Verzeichnis). 

Das Interface java.net. FileNameMap enthält die Methode 
String getContentTypeFor (String fileNaine) . 

Sie liefert den MIME-Typ zu einem Dateinamen. 



5.5 Webseiten dynamisch erzeugen 

Wir erweitern nun den Mini-Webserver aus Kapitel 5.4 um zu- 
sätzliche Funktionen. 

So können dann z.B. Formulare ausgewertet, Daten in einer 
Datenbank abgespeichert oder abgefragt werden. Zu diesem 
Zweck unterstützt der neue Server auch die POST-Methode. 

Die neue Anwendungsfunktionalität zur dynamischen Erzeugung 
von HTML-Seiten wird in eigenen Klassen (im Weiteren Anwen- 
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dungsmodule genannt) - unabhängig vom Webserver - realisiert. 
Diese Klassen werden nach Bedarf zur Laufzeit des Webservers 
dynamisch hinzu geladen. 



Die Klassen XMiniwebServer und Miniwebserver (aus Kapitel 5.4) sind 
mit Ausnahme des Namens und der package-Klausel identisch. 




-> = benutzt 



Wie HttpConnection aus Kapitel 5.4, aber mit Unterstützung der 
POST-Methode: 



// Nur GET und POST sind zulässig 
if (method . equals ( "GET" ) ) 

(new HttpGetHandler (dir, alias, reguest, response) ) .process () ; 
eise if (method. eguals ("POST") ) 

(new HttpPostHandl er (reguest, response) ) .process () ; 
eise 

throw new HttpException ( "Nur GET und POST sind zulässig", 501); 



HttpException entspricht der gleichnamigen Klasse aus Kapitel 5.4. 



Hier sind zwei neue Methoden vorhanden: 

public int getContentLength ( ) { 

String value = getHeader ("content-length") ; 
if (value != null) 

retum Integer .parseint (value) ; 
eise 

retum -1; 

> 



public BufferedReader getBuf feredReader ( ) { 
return in; 

> 



XMiniWebServer 



Bild 5.7: 

Die Klassen 
des erweiterten 
Webservers 



HttpConnection 



HttpExceptio n 
HttpRequest 
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HttpResponse 

HttpGetHandler 



HttpResponse entspricht der gleichnamigen Klasse aus Kapitel 5.4. 



Gegenüber der Version aus Kapitel 5.4 enthält diese Klasse eine 
geänderte Methode process und die neue Methode execute. process 
behandelt Ressourcennamen der Form /prog/xxx auf besondere 
Weise. Xxx wird als Anwendungsmodul im oberen Sinne betrach- 
tet. Der vollständige Klassenname ist dann prog.xxx. 



public void process () throws IOException, HttpException { 

String path = request.getPathQ ; 

String query = request . getQuery ( ) ; 

// Ein Pfad der Form "/prog/Xxx" führt zum Laden der Klasse prog.Xxx 

int idx = path. lastlndexOf ('/'); 

String s = path. substring (0, idx) ; 

if (s.equals ("/prog") ) { 

String classname = path . substring ( 1 ) . replace ' . ' ) ; 

execute (classname) ; 

retum; 

} 



if (query. length() > 0) 

throw new HttpException ( "Programmpfad unbekannt", 404) ; 

if (path . endsWith ("/")) 

path = path + "index.html"; 

String filename = getFilename (path) ; 

File file = new File (filename) ; 

FilelnputStream fis = null; 
try { 

fis = new FilelnputStream (file) ; 

String type = URLConnection . getFileNameMap ( ) . getContentTypeFor ( 
filename) ; 
if (type = null) { 

type = "application/octet-stream" ; 

} 

response. addHeader ("Content-Type", type) ; 
response . addHeader ( "Content-Length" , 

String.valueOf (file.lengthQ ) ) ; 
response .printStatus (200) ; 
response. printHeaders () ; 

OutputStream out = response. getOutputStreamO ; 
byte data[] = new byte[1024]; 
int ent; 

while ((ent = f is . read (data) ) != -1) { 
out. write (data, 0, ent); 
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out . f lush ( ) ; 

} 

catch (SecurityException e) { 

throw new HttpException(e.getMessage () , 400) ; 

} 

catch (FileNotFoundException e) { 

throw new HttpException(e.getMessage () , 404) ; 

} 

finally ( 
try { 

if (fis != null) 
fis.closeO ; 

> 

catch (IOException e) { } 

} 



private void execute (String classname) throws IOException, 
HttpException ( 
try ( 

// Klasse laden 

Class c = Class. forName (classname) ; 

// Methode "getlnstance" bereitstellen 
Class [ ] types = { } ; 

Method m = c.getMethod("getInstance", types); 

// getlnstance auf rufen 
Object [ ] args = {}; 

XProg p = (XProg) m.invoke(null, args); 
p.doGet (request, response) ; 

} 

catch (ClassNotFoundException e) ( 

throw new HttpException (e.getMessage () , 404) ; 

} 

catch (Exception e) ( 

throw new HttpException (e.getMessage () , 500); 

} 



Die Klasse prog.xxx wird geladen. Anwendungsmodule sind Sub- 
klassen der abstrakten Klasse XProg und enthalten die statische 
Methode getlnstance (ohne Parameter) sowie die Methoden doGet 
und doPost. 

Die ciass-Methode 

Method getl^fethod (String name, Class... parameterTypes) 
throws NoSuchMethodException 

liefert ein Method-Objekt. narre ist der Name der gewünschten 
pubüc-Methode, parameterTypes sind die Parametertypen dieser 
Methode, durch ciass-Objekte repräsentiert. 

Die Klasse java. lang. refiect. Method repräsentiert eine Methode. 
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Die tfethod-Methode 

Object imrake (Ob ject obj, Object... args) 
throws IllegalAccessException, 
java . lang.reflect . InvocationTargetException 

ruft die durch dieses Method-Objekt repräsentierte Methode auf. 
obj ist das Objekt, für das die Methode ausgeführt werden soll, 
args sind die Argumente für den Methodenaufruf. Bei einfachen 
Datentypen werden hier die entsprechenden Hüllobjekte einge- 
setzt. Ist die Methode statisch, so wird obj ignoriert und kann null 
sein. 

In unserem Fall wird die Klassenmethode getinstance des gelade- 
nen Anwendungsmoduls aufgerufen. Sie liefert eine Instanz des 
Anwendungsmoduls vom Typ xprog. Hierfür wird nun doGet auf- 
gerufen. 

Dieser indirekte Mechanismus zum Laden von Klassen und Auf- 
ruf von Methoden ermöglicht es, dass die Klasse zum Zeitpunkt 
der Compilierung nicht bekannt sein muss. 



HttpPostHandler 



package xwebserver; 

Import java. io.*; 

import java. lang.reflect.*; 



public dass HttpPostHandler { 
private HttpRequest request; 
private HttpResponse response; 

public HttpPostHandler (HttpRequest request, HttpResponse response) { 
this. request = request; 
this . response = response; 

} 



public void process ( ) throws IOException, HttpException ( 
String path = request . getPath ( ) ; 

// Ein Pfad der Form "/prog/Xxx" führt zum Laden der Klasse 
// prog.Xxx 

int idx = path . lastlndexOf ('/'); 

String s = path. substring (0, idx); 

if (s.equals ("/prog") ) { 

String classname = path. substring (1) . replace ( ' / ' , ' . ' ) ; 

execute (classname) ; 

retum; 

} 

eise 

throw new HttpException ("Progranmpfad unbekannt", 404); 
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private void execute (String classname) throws IOException, 
HttpException { 

try { 

// Klasse laden 

Class c = Class . forName (classname) ; 

// Methode "getlnstance" bereitstellen 
Class [ ] types = ( } ; 

Method m = c.getMathod( "getlnstance", types); 

// getlnstance aufrufen 
Object [ ] args = ( } ; 

XProg p = (XProg) m.invoke(null, args); 
p . ddPost ( request , response ) ; 

) 

catch (ClassNotFoundException e) { 

throw new HttpException (e . getMessage 0 , 404); 

) 

catch (Exception e) { 

throw new HttpException (e . getMessage ( ) , 500 ) ; 

} 




Anwendungsmodule müssen von der abstrakten Klasse XProg 
abgeleitet sein. XProg implementiert so genannte Default- 
Methoden, die ausgeführt werden, falls das Anwendungsmodul 
die entsprechende Methode nicht überschreibt. 



package xwebserver; 

import java.io.*; 

public abstract class XProg < 

public void doGet (HttpRequest request, HttpResponse response) 
throws IOException { 

response . addHeader ( "Content-TYpe" , "text/html" ) ; 
response. printstat us (200) ; 
response. printHeaders () ; 

int Status = 501; 

String statusMsg = Status + " " + response. getStatusText (Status) ; 
StringBuilder msg = new StringBuilder () ; 

msg.append("<html><head><title>" + statusMsg + "</titlex/head>") ; 
msg.append("<body><hl>GET nicht unterstützt</hlx/bodyx/html>" ) ; 

OutputStream out = response. getOutputStream () ; 
out .write (msg.toStringO .getBytes ("ISO-8859-1") ) ; 
out . f lush ( ) ; 



XProg 
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HttpQuery 



public void doPost (HttpRequest request, HttpResponse response) 
throws IOException { 

response. addHeader ("Content-Type", "text/html") ; 
response .printStatus (200) ; 
response. printHeaders () ; 

int Status = 501; 

String statusMsg = Status + " " + response. getStat usText (Status) ; 
StringBuilder msg = new StringBuilder () ; 

msg.append("<htmlxhead><title>" + statusMsg + "</titlex/head>") ; 
msg.append("<body><hl>POST nicht unterstützt</hlx/bodyX/html>") ; 

OutputStream out = response. getOutputStreamf) ; 
out .write (msg.toStringO .getBytes ("ISO-8859-1") ) ; 
out.flushO ; 




Die Klasse HttpQuery enthält Methoden, die Parameterwerte eines 
Query Strings in decodierter Form bereitstellen. Zu beachten ist, 
dass ein Parametername in einem Query String auch mehrfach 
auftreten kann. Parametername und -wert werden in einer Hash- 
table gespeichert. Der Parametername stellt den Schlüssel dar, 
die evtl, mehrfach auftretenden Parameterwerte zum gleichen 
Namen werden in einem Vektor zusammengefasst, der dann als 
Wert zum Schlüssel in die Hash fable eingetragen wird. 



package xwebserver; 

import java.net.*; 
import java.util.*; 
import java.io.*; 

public dass HttpQuery { 

private Hashtable<String, Vector<String» h; 

public HttpQuery (String query) { 

h = new Hashtable<String, Vector<String» ( ) ; 
parseQueryString (query) ; 

} 



public String getParameter (String name) { 
Vector<String> v = h.get(name) ; 
if (v = null) 
retum null; 
eise 

retum v . get ( 0 ) ; 



public String [] getParameterValues (String name) { 
Vector<String> v = h. get (name) ; 
if (v = null) 
retum null; 
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eise { 

Stringt] result = new String [v. size ()] ; 
v.copylnto (result) ; 
retum result; 




/* Allgemeine Form eines Query Strings: 
name l=value 1 & name2 =value2 . . . 

Ein Feldname kann auch mehrfach auf treten. */ 

private void parseQueryString (String query) { 

StringTokenizer params = new StringTokenizer (query, 
StringTokenizer param; 

String name, value; 

while (params. hasMoreTokens () ) { 

param = new StringTokenizer (params.nextTokenQ , 
name = par am.next Token () ; 
i f (param . hasMoreTokens ( ) ) 
value = par am.next Token () ; 
eise 
value = 

if (name != null) { 

String dvalue = 
try { 

dvalue = URLDecoder . decode (value, "ISO-8859-1") ; 

} 

catch (Unsupport edEncodingException e) { } 

// Prüfen, ob der Name bereits in der Hashtable vorkomnt. 
// Die Werte werden jeweils in einem Vektor gespeichert. 

Vector<String> v = h.get(name); 
if (v = null) { 

v = new Vector<String> ( ) ; 
v.add (dvalue) ; 
h. put (name, v) ; 

} 

eise { 

v.add (dvalue) ; 




Das Anwendungsmodul Test soll die neuen Funktionen demonst- 
rieren. Test wertet ein Formular aus. 
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post.html 



Test 



<html> 

<head><title>Test (POST) </titlex/head> 

<body> 

<fom action="/prog/Test" method="POST"> 

Name: <input type="text" size="60" name="name"/xp/> 

<input type="checkbox" name="sprache" value="Java"/>Java<br/> 
<input type="checkbox" name="sprache" value="C++"/>C++<br/> 
<input type="checkbox" name="sprache" value="C#"/>C#<p/> 
<input type="submit" value="Senden"/> 

<input type="reset" value="Löschen"/> 

</form> 

</body> 

</html> 

package prog; 

import java.io.*; 
import java.util.*; 
import xwebserver.*; 

public dass Test extends XProg { 

private static final XProg INSTANCE = new Test ( ) ; 

private Test ( ) ( ) 

public static XProg getlnstance () < 
retum INSTANCE; 

} 



public void doGet (HttpRequest request, HttpResponse response) 
throws IOException { 

String q = request . getQuery ( ) ; 
process (request, response, q) ; 



public void doPost (HttpRequest request, HttpResponse response) 
throws IOException { 

BufferedReader in = request . getBuff eredReader () ; 
int length = request. getContentLength () ; 

int c; 

StringBuilder sb = new StringBuilder ( ) ; 
for (int i = 0; i < length; i++) { 
c = in . read ( ) ; 
if (c == -1) 
break; 

sb.append( (char) c) ; 

} 



String q = sb.toStringQ ; 
process (request, response, q) ; 
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private void process (HttpRequest request, HttpResponse response, 
String q) throws IOException { 

HttpQuery query = new HttpQuery (q) ; 

String narrte = query . getParameter ( "narrte" ) ; 

String [ ] sprachen = query . getPararrteterValues ( " spräche" ) ; 

response . addHeader ( "Content-Type" , "text /html " ) ; 
response. printStatus (200) ; 
response. printHeaders () ; 

StringBuilder buff er = new StringBuilder () ; 

buff er . append ( "<htmlxhead><title>Test</title></head>" ) ; 

buffer.append("<body><hl>Request Header</hl>") ; 

Hashtable<String, String> headers = request . getHeaders () ; 
Enumeration<String> e = headers. keys () ; 
while (e.hasiybreElements () ) { 

String key = e.nextElement () ; 

buf f er. append (key + ": " + headers . get (key) + "<br/>"); 

} 



buf f er . append ( "<hl>Formularparameter</hl>" ) ; 
buff er. append ("Name: " + name + "<p/>") ; 
buf f er . append ( "Prograrrmiersprachen : <br/>" ) ; 
if (sprachen != null) { 

for (int i = 0; i < sprachen . length; i++) 
buf f er . append ( sprachen [ i ] + " <br /> " ) ; 

} 

buf f er . append ( "</bodyx/html>" ) ; 

OutputStream out = response. getOutputStream () ; 
out .write (buffer.toStringO .getBytes ("ISO-8859-1") ) ; 
out.flush() ; 




Die Klasse Test ist ein so genannter Singleton, d.h. sie wird ge- 
nau einmal instanziiert. Bei jedem Aufruf wird die vorhandene 
Instanz zurückgeliefert, so dass also zur Laufzeit des Servers 
höchstens ein Objekt dieser Klasse vorhanden ist. 



Name: |Hugo Meier 
1? Java 

rc++ 

EiC# 

Senden | Loschen | 



Bild 5.8: 

Formular post.html 
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Bild 5.9: 

Ergebnis 



Request Header 

connection: keep-alive 

accept-encoding: gzap,deflate 

referer : http //localhost: 5 0 0 0 0/post html 

accept: text/xml,apphcation/xml,apphcatJon/xhtml+xml, text/html, q=0 9.text/plam,q=0 8,image/png,*/*,q=0 5 
content-length 41 

accept-charset ISO-8859- 1 ,utf-8,q=0 7,*,q=0 7 
ac c ept-language de - de , de , q=0 8 ,en-us , q=0 5 , en, q=0 3 

user-agent: Mozilla/5.0 (Windows, U, Windows NT 5.0, de, rv: 1.8.0. 1) Gecko/20060111 Firefox/ 1.5. 0.1 
content-type: application/x-www-form-urlencoded 
keep-alive: 300 
host. localhost:50000 

Formular parameter 

Name Hugo Meier 

Programmiersprachen 

Java 

C# 



Die Anwendung der cxr-Methode (im Formular ist post durch get 
zu ersetzen) führt zu einem entsprechenden Ergebnis. 



5.6 Aufgaben 

1. Entwickeln Sie ein Programm, mit dem Dateien vom Web- 
server mittels HTTP herunter geladen werden können. Nut- 
zen Sie hierzu die Socket-Programmierung mit TCP (siehe 
Kapitel 4). 

2. Realisieren Sie eine Variante zum Downloadprogramm in 
Aufgabe 1, indem Sie die folgenden Methoden der Klassen 
ukl und URLConnection benutzen. 

Die Klasse java.net.URL repräsentiert einen Uniform Resource 
Locator. 

URL (String spec) throws MalformedURIException 

erzeugt ein URL-Objekt aus der Zeichenkette spec. Die Klasse 

java.net.MalfomedURLException ist von java.io.IOException abge- 
leitet. 

Die Klasse URL-Methode 

URLConnection openConnection ( ) throws IOException 
liefert ein java.net.URLConnection-Objekt, das eine Verbindung 
zu einer durch den URL adressierten Ressource repräsen- 
tiert. 
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UKLConnection-Methoden : 

void connect ( ) throws IOException 

stellt einer Verbindung zu der durch den URL adressierten 
Ressource her. 

int getContentLength ( ) 

liefert den Wert des Antwortparameters Content -Length. 
InputStream getlnputStream ( ) throws IOException 

liefert einen Eingabestrom zum Lesen über diese Verbin- 
dung. 

3. Entwickeln Sie für den erweiterten Webserver XMiniwebServer 
aus Kapitel 5.5 ein Anwendungsmodul Buecherüste, das zu 
einem vom Benutzer in einem Formular eingegebenen Wort 
Angaben zu denjenigen Büchern aus einer Bücher- 
Datenbank anzeigt, deren Titel dieses Wort enthalten. 

Hierzu ist die Datei java.policy anzupassen. Das Programm 
muss eine Socket-Verbindung zum Port des Datenbankser- 
vers aufnehmen können (bei MySQL Portnummer 3306) und 
Leserecht für den JDBC-Treiber haben, z. B. 

permission java. io. FilePermission " C:\\Programme\\ java\\-", 
"read"; 

(falls sich der JDBC-Treiber im Verzeichnis <Java-Inst>\ 
lib\ext befindet). 

4. Entwickeln Sie eine Variante des Webservers aus Kapitel 
5.4, die einen Thread-Pool nutzt (siehe Kapitel 4.8). 

In der Datei java.policy muss die folgende Regel zusätzlich 
eingefügt werden: 

permission java. lang. RuntimePermission "modifyThread"; 




6 XML Remote Procedure Calls (XML-RPC) 



Eine bewährte und sehr verbreitete Technik zur Entwicklung von 
Client-Server-Anwendungen ist der so genannte Remote Pro- 
cedure Call (RPC). Der Client ruft mit einem lokalen Prozedur- 
aufruf einen Dienst auf, der in der Regel auf einem anderen 
Rechner angeboten wird. Implementierungen des RPC-Mecha- 
nismus unterscheiden sich im Allgemeinen für verschiedene 
Programmiersprachen . 

In diesem Kapitel wird am Beispiel von XML-RPC gezeigt, wie 
das Protokoll HTTP und XML als Kommunikationsformat für den 
entfernten Prozeduraufruf eingesetzt werden können. Vom Kon- 
zept her ist diese Technik programmiersprachenunabhängig. Wir 
werden uns hauptsächlich mit der Java-Implementierung be- 
schäftigen. Die Aufgabe 5 dieses Kapitels nutzt eine PHP-Imple- 
mentierung auf der Client-Seite. 

6.1 Grundkonzept und ein erstes Beispiel 

XML-RPC ist ein einfaches Protokoll für den entfernten Pro- 
zeduraufruf (RPC). XML-RPC verwendet XML als Datenaustausch- 
format. Anfrage (Methodenname, Parameter) und Antwort (Rück- 
gabewert des Methodenaufrufs) werden als XML-Dokumente mit 
HTTP übermittelt. 

Bild 6.1 zeigt den Nutzdatenteil der HTTP -Anfrage (HTTP- 
Methode ist post) und den Nutzdatenteil der HTTP-Antwort beim 
Aufruf der entfernten Methode getEcho. 



XML-RPC- Anfrage 




Bild 6.1 

XML-RPC -Anfrage 
und Antwort 



XML-RPC-Antwort 
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Die Nutzdatenteile werden auch als XML-RPC -Anfrage bzw. 
-Antwort bezeichnet. 

Eine XML-RPC-Anfrage kann mehrere Parameterwerte enthalten 
(gemäß der Signatur der entfernten Methode). Eine XML-RPC- 
Antwort enthält jedoch genau einen Wert. 


Struktur der 
XML-RPC-A nfrage 


<methodCall> 

<methodNarne>Methodenname< / met hodName> 
<params> 

<param> 

<value>Parameterwert</value> 

</param> 

</params> 

</methodCall> 


Struktur der 
XML-RPC-Antwort 


<methodResponse> 

<params> 

<param> 

<value>Rückgabewert</value> 

</param> 

</params> 

</methodResponse> 


Datentypen 


Parameter- und Rückgabewerte haben jeweils einen bestimmten 
Datentyp. XML-RPC unterstützt insgesamt acht Datentypen: 
einfache Datentypen (z.B. Zeichenketten, Zahlen) und zusam- 
mengesetzte Datentypen (z.B. Arrays). 

Die Datentypen werden im nächsten Abschnitt einzeln anhand 
von Programmbeispielen vorgestellt. 


Spezifikation 


Die Spezifikation von XML-RPC wurde 1999 von Dave Winer 
veröffentlicht. Sie umfasst nur wenige Seiten und kann unter der 
Adresse 

http : / /www . xmlrpc . com 

nachgeschlagen werden. 

Lmplementierungen von XML-RPC existieren für verschiedene 
Programmier- und Skriptsprachen (z.B. Java, Perl, PHP, Python). 
Somit kann beispielsweise ein PHP-Client mit einem Java-Server 
kommunizieren (siehe Aufgabe 5). 


Apache XML-RPC 


Wir nutzen im Folgenden die Java-Implementierung Apache 
XML-RPC der Apache Software Foundation in der Version 3-0. 
Die erforderlichen Klassenbibliotheken (JAR-Dateien) können 
von der Website 
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http : //ws . apache . org/xmlrpc/ 
heruntergeladen werden. 

Die JAR-Dateien können in ein Verzeichnis Ihrer Wahl kopiert 
werden (siehe auch die Programmsammlung zu diesem Buch). 

Die Version 3-0 von Apache XML-RPC erfüllt die offizielle XML- 
RPC-Spezifikation, bietet aber auch Erweiterungen (Unterstüt- 
zung zusätzlicher Datentypen, Performancesteigerung durch 
Nutzung des so genannten Streaming-Verfahrens, Datenkompres- 
sion), die in einer reinen Java-Umgebung sinnvoll eingesetzt 
werden können. Wir beschränken uns hier hauptsächlich auf die 
Vorstellung der zur XML-RPC-Spezifikation kompatiblen Aspekte. 
Lediglich Programm 6.10 geht in einem Aspekt auf die Erweite- 
rungen ein. 



Eine Weiterentwicklung von XML-RPC ist SOAP, das vom World 
Wide Web Consortium (W3C) definiert wird und neben anderen 
Standardtechnologien zur Entwicklung von so genannten Web 
Services genutzt wird. SOAP war ehemals Abkürzung für "Simple 
Object Access Protocol" und ist jetzt ein eigenständiger Name. 

Im Vergleich zu SOAP hat XML-RPC einen geringeren Leistungs- 
umfang, ist aber auch wesentlich einfacher in der Handhabung. 
Für viele Anwendungen erweist sich XML-RPC als völlig ausrei- 
chend und kann auch für die Implementierung von Web Servi- 
ces eingesetzt werden. 



Zur Implementierung eines XML-RPC-Servers stellt Apache XML- 
RPC die Klassen 

org. apache .xmlrpc. Webserver .Webserver und 
org . apache . xmlrpc . Server . XmlRpcServer 

zur Verfügung. 

Webserver implementiert einen speziell für die Behandlung von 
XML-RPC-Anfragen geeigneten HTTP-Server, der in eigene Ap- 
plikationen eingebettet werden kann. Dieser ist zu Testzwecken 
sehr gut geeignet. Für höhere Ansprüche in Bezug auf Perfor- 
mance und Stabilität sind ausgereifte Servlet-Container wie bei- 
spielsweise Apache Tomcat besser geeignet. 

Die Klasse »niFpcServer verarbeitet die XML-RPC-Anfragen. 



Webserver ( int port) 

erzeugt einen Server mit der Portnummer port. 

WebServer-Methoden: 

void start () throws java.io.IOException 

startet den Server. 



SOAP 



Webserver und 
Xm IRpc Server 
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Händler 



Programm 6.1 



void shutdown ( ) 

stoppt den Server. 

Die Methode get5!mlPpc£erver() liefert ein XniFpcServer-Objekt. 



Ein so genannter Händler ist eine entfernt aufrufbare Methode. 

Folgende Bedingungen müssen erfüllet sein: 

• Die Methode muss public sein, nicht static sein und darf nicht 
den Rückgabetyp void haben. 

• In der Klasse, die den Händler implementiert, muss der pa- 
rameterlose Standardkonstruktor implizit oder explizit vor- 
handen sein. 



Die Klasse org.apache.xmlrpc. Server. PropertyHandlerMapping kann 
mehrere Händler verwalten. 

Ihre Methode 

void addHandler (String key, Class typ) throws XmlRpcExcept ion 

fügt die Handler-Klasse typ mit dem Namen key hinzu. Hierzu 
wird das ciass-Objekt der Handler-Klasse angegeben: 

Klassenname . class. 



Eine Ausnahme vom Typ org.apache.xniLrpc.XmlRpc£xception wird 
generell ausgelöst, wenn der Server einen Fehler meldet. 



void removeHandler (String key) 

entfernt alle Händler mit dem Namen key. 



Mit dem Aufruf der XnüJpcServer-Methode setHancüeiMapping wer- 
den die Händler für das »niPpcServer-Objekt registriert: 

setHand lerMapping ( propert yHandlerMapping ) 



Das folgende Beispiel demonstriert eine einfache XML-RPC- 
Anwendung. 

Die Klasse Echo implementiert die Methoden getEcho und 
getEchowithDate, die ein "Echo" ohne bzw. mit Serverdatum zu- 
rückgeben. 
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import java.util.*; 
import java.text.*; 

public dass Echo { 

public String getEcho (String s) { 
retum s; 

} 



public String getEchoWithDate (String s) { 

SimpleDateFormat f = new SimpleDateFormat ("dd.Myi.yyYy HH:nm: ss") ; 
retum "[" + f . format (new DateO) + "] " + s; 



} 



Die Klasse Echoserver erzeugt eine Instanz der Klasse Webserver, 
registriert den Echo-Dienst mit dem Namen "echo" und startet 
dann den Server. 



iirport org . apache . xmlrpc . Server . * ; 
iirport org . apache . xmlrpc . Webserver . * ; 

public dass EchoServer { 

public static void main (String [] args) throws Exception { 
int port = Integer. parse Int (args [0] ) ; 

PropertyHandlerMapping phm = new PropertyHandlerMappingQ ; 
phm . addHandler ( "echo" , Echo . dass ) ; 

Webserver Webserver = new Webserver (port) ; 

XmlRpcServer Server = Webserver . getXmlRpcServer ( ) ; 

Server . setHanderMapping (phm) ; 

Webserver . Start ( ) ; 



} 



Zur Implementierung eines XML-RPC-Client stellt Apache XML- 
RPC die Klasse 

org . apache . xmlrpc . dient . XmlRpcClient 

zur Verfügung. 

Mit Hilfe der Klasse 

org . apache . xmlrpc . dient . XmlRpcClientConfiglrrpl 
kann ein »niRpcciient-Objekt konfiguriert werden. 

Die XmlPpcClientConfiglmpl-Methode 
void setServerURL ( java.net. URL url) 

legt den URL des Servers fest. Im Beispiel: http ://iocaihost: 50000. 



Echo 



EchoServer 



XmlRpcClient 
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execute 



EchoClient 



Ablauf beim 

entfernten 

Methodenaufruf 



Mit dem Aufruf der xmiRpcCiient-Methode setconfig wird die Kon- 
figuration config für den Client gesetzt: setconfig (config). 



Object execute (String method, Object [] params) throws XmlRpcException 

erzeugt eine XML-RPC-Anfrage und sendet sie mittels HTTP zum 
Server. Die zurückgeschickte XML-RPC- Antwort wird geparst und 
als Objekt vom Typ Object zurückgegeben. 

Der String method hat den Aufbau: 

Dienstname . Methodenname 

Dienstname ist der Name, unter dem der Dienst auf der Serverseite 
registriert ist. tfethodenname ist der Name der Methode, die der 
Dienst implementiert hat. Das Array params enthält die erforderli- 
chen Parameter. 

Wie die Parameter passend zur Signatur der Methode erzeugt 
werden müssen, zeigen die nächsten Programmbeispiele. 



EchoClient ruft beide Methoden des Echo-Dienstes mit dem Ar- 
gument "Hallo" auf. 



import java.net.*; 

import org . apache . xmlrpc . dient . * ; 

public dass EchoClient { 

public static void min (String args [ ] ) throws Exception { 

URL url = new URL (args [0] ) ; 

XmlRpcClient Configlmpl config = new XmlRpcClientConf iglmpl ( ) ; 
config. setServerURL (url) ; 

XmlRpcClient dient = new XmlRpcClient ( ) ; 
dient . setConfig (config) ; 

Object [] params = {"Hallo"}; 

String s = (String) dient. execute ("echo.getEcho", params); 
System . out . print ln ( s ) ; 

String t = (String) dient . execute ( 

"echo . getEchoWithDate " , params) ; 

System. out .print ln (t) ; 




Die einzelnen Schritte beim entfernten Methodenaufruf sind: 

1. Das Client-Programm erzeugt eine xmii^cciient-Instanz, konfi- 
guriert sie und ruft dann die Methode execute mit Angabe des 
Dienstnamens, des Methodennamens und der Parameter auf. 

2. Diese Angaben werden in ein XML-Dokument verpackt und 
per http-post an den Server geschickt. 
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3. Der Server empfängt die HTTP -Anfrage und leitet die Verar- 
beitung des XML-Dokuments ein. 

4. Das XML-Dokument wird geparst und anschließend die an- 
gegebene Methode des Dienstes aufgerufen. 

5. Die Methode übergibt das Ergebnis an den XML-RPC- 
Verarbeitungsprozess, der dann das Ergebnis in ein XML- 
Dokument verpackt. 

6. Der Server schickt das XML-Dokument als Antwort auf die 
HTTP -Anfrage zurück. 

7. Der XML-RPC-Client parst das XML-Dokument, extrahiert den 
Rückgabewert und übergibt diesen als Objekt an das Client- 
Programm. 



Dienste 




Transformation 



Transformation 



Bild 62: 

Kommunikation 
zwischen Client 
und Server 



Bevor das Werkzeug Ant mit build.xml aus der Programmsamm- 
lung genutzt werden kann, muss die Umgebungsvariable 
xmlrpc_path gesetzt werden. Hier müssen alle erforderlichen JAR- 
Dateien aufgeführt werden. 

set XMLRPC_PATH=Verzeichnis/xxx . jar; . . . 



1. Compilieren: ant compile 

2. Server starten: ant Server 

3. Client Starten: ant Client 

Ausgabe: 

Hallo 

[09.08.2006 14:15:33] Hallo 

Verzichtet man auf die Nutzung des Werkzeugs Ant, so können 
obige drei Schritte wie folgt ausgeführt werden: 

mkdir build 

javac -sourcepath src -cp %XMLRPC_PATH% -d build src/* . java 

Start java -cp build; %XMLRPC_PATH% EchoServer 50000 

java -cp build; %XMLRPC_PATH% EchoClient http ://localhost: 50000 
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Datentypen 



6.2 XML-RPC-Datentypen 

Zu den einfachen Datentypen gehören: 

• Ganzzahl, 

• Gleitkommazahl, 

• Wahrheitsweit, 

• Zeichenkette, 

• Datum/Zeit, 

• Binärdaten. 

Zusammengesetzte Datentypen sind: 

• Array und 

• Struktur. 

Ein Array-Element kann einen Wert vom einfachen oder zusam- 
mengesetzten Datentyp enthalten. 

Eine Struktur ist eine Folge von Elementen, die jeweils aus einem 
Namen und einem Wert bestehen. Der Name muss eine Zei- 
chenkette sein, der Wert kann vom einfachen oder zusammen- 
gesetzten Datentyp sein. 



Die folgende Tabelle gibt eine Übersicht. 



XML-Tag-Name 


Java-Typ für execute 


Java-Typ für Händler 


i4 


java . lang . Integer 


int 


double 


java . lang . Double 


double 


boolean 


j ava . lang . Boolean 


boolean 


string 


java . lang . String 


java . lang . String 


dateTime . iso8 601 


java. util. Date 


java. util. Date 


base 64 


byte [] 


byte [] 


array 


java . lang . Ob ject [ ] 


java . lang . Object [ ] 


struct 


java. util. Map 


java. util. Map 



Die erste Tabellenspalte enthält die Namen der Tags für das vom 
XML-RPC-Protokoll verwendete XML-Dokument. Diese Tags mar- 
kieren den Datenwert zum entsprechenden Datentyp. Die zweite 
Spalte enthält die Entsprechungen in Java für den Aufruf der 
xmiRpcCiient-Methode execute. Die Datentypen der dritten Spalte 
werden als Parameter- bzw. Rückgabetypen der Händler benutzt. 
void-Methoden sind als Händler-Methoden nicht erlaubt. Der 
Wert null ist weder als Argumentwert noch als Rückgabewert 
erlaubt. 
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Mit Programm 6.2 kann die Handhabung der verschiedenen Programm 62 
Datentypen getestet werden. 



inport org.apache.xmlrpc. Server.*; DatentypTestServer 

iirport org . apache . xmlrpc . Webserver . * ; 

public dass DatentypTestServer { 

public static void main (String [] args) throws Exception { 
int port = Integer. parse Int (args [0] ) ; 

PropertyHandlerMapping phm = new PropertyHandlerMappingO ; 
pbm . addHandler ( "test " , DatentypTest . dass ) ; 

Webserver Webserver = new Webserver (port) ; 

XmlRpcServer Server = Webserver . getXmlRpcServer ( ) ; 

Server . setHanderMapping (phm) ; 

Webserver . Start ( ) ; 



} 



Die Handler-Klasse DatentypTest enthält für jeden XML-RPC- DatentypTest 
Datentyp eine Testmethode. 



import java.util.*; 
import java.io.*; 

public dass DatentypTest { 

// Ganzzahl 

public int testint (int x) { 
return x; 

} 



// Gleitkammazahl 

public double testDouble (double x) ( 
return x; 

} 



// Wahrheitswert 

public boolean testBoolean (boolean x) { 
return x; 

} 



// Zeichenkette 

public String testString (String x) { 
return x; 

} 



// Datum/Zeit 

public Date testDateTime (Date x) { 
return x; 

} 
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Da ten typ TestClien t 



// Binärdaten 

public byte [ ] testBase64 ( ) throws IOException ( 
InputStream in = new FileInputStreamCjava.gif") ; 
ByteArrayOutputStream out = new ByteArrayOutputStream ( ) ; 
int c; 

while ( (c = in.readQ) != -1) { 
out.write (c) ; 

} 

in . close ( ) ; 

retum out.toByteArray () ; 



// Array 

public Object [ ] testArray (Object [ ] x) ( 
retum x; 

} 



// Struktur 

public Map testStruct (Map x) { 
retum x; 

} 

} 



Die Klasse DatentypTestciient enthält für jeden XML-RPC-Datentyp 
den Aufruf der zugehörigen Testmethode. 



import java.util.*; 

import java.io.*; 

import java.net.*; 

import org.apache.xmlrpc. Client.*; 

public dass DatentypTestciient { 

public static void main (String args [ ] ) throws Exception { 

DKL url = new URL (args [0] ) ; 

String typ = args[l]; 

XmlRpcClientConfiglmpl config = new XmlRpcClientConfiglmpl () ; 
conf ig . setServerURL (url) ; 

XmlRpcClient dient = new XmlRpcClient ( ) ; 

Client . setConfig (config) ; 

// Ganzzahl 

if (typ.equals ("int") ) { 

System. out .printin (typ) ; 

Object (] params = {1234}; 

int r = (Integer) dient. executeC'test.testlnt", params) ; 
System, out .printin (r) ; 

System. out .printin ( ) ; 

} 

// Gleitkommazahl 

eise if (typ.equals ("double") ) { 

System. out .printin (typ) ; 

Objectt] params = {123.456}; 

double r = (Double) dient. execute ("test.testDouble", params); 
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System. out .printin (r) ; 

System. out .printin ( ) ; 

} 

// Wahrheitswert 

eise if (typ . equals ( "boolean" ) ) ( 

System. out .printin (typ) ; 

Object [] params = {true}; 

boolean r = (Boolean) dient. execute( 

"test.testBoolean", params); 

System. out .printin (r) ; 

System, out .printin ( ) ; 

) 

// Zeichenkette 

eise if (typ. equals ("string") ) { 

System, out .printin (typ) ; 

Object [] params = {"< — A & 0 — >"}; 

String r = (String) dient. execute ("test.testString", params); 
System. out .printin (r) ; 

System. out .printin ( ) ; 

) 

// Datum/ Zeit 

eise if (typ. equals ("dateTime") ) ( 

System, out .printin (typ) ; 

Object [] params = (new DateO }; 

Date r = (Date) dient. execute ("test.testDateTime", params); 
System. out .printin (r) ; 

System. out .printin ( ) ; 

) 

// Binärdaten 

eise if (typ . equals ( "base64 " ) ) { 

System. out .printin (typ) ; 

Object [ ] params = { ) ; 

byte[] r= (byte[]) dient. execute ("test. testBase64", params); 
OutputStream out = new FileOutputStream ( "test . gif " ) ; 
for (int i = 0; i < r.length; i++) { 
out .write (r [i] ) ; 

) 

out . f lush ( ) ; 
out . close ( ) ; 

System. out .printin ( ) ; 

> 

// Array 

eise if (typ. equals ("array") ) ( 

System, out .printin (typ) ; 

Object[] array = ("Das ist ein String", 4711}; 

Object [] params = (array}; 

Object [ ] r = (Object [ ] ) dient . execute ( 

"test . testArray " , params ) ; 
for (Object obj : r) ( 

System, out . printin (ob j ) ; 

} 

System. out .printin ( ) ; 

} 

// Struktur 

eise if (typ. equals ("struct") ) { 

System, out .printin (typ) ; 

Map map = new HashMap ( ) ; 
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Ganzzahl 



Gleitkom mazahl 



map. put ("Vorname", "Hugo"); 
map . put ( "Nachname" , "Meier" ) ; 

Object (] params = {map}; 

Map r = (Map) Client. execute ("test.testStruct", params); 

System. out .printin (r.get ("Vorname") + " " + r.get ("Nachname") ) ; 
System, out .printin ( ) ; 

} 

// XmlRpcException 

eise if (typ. equals ("fault") ) { 

System. out .printin (typ) ; 

Object { ] params = { } ; 

int r = (Integer) dient. execute ("test.testFault", params); 
System, out .printin (r) ; 

System. out .printin ( ) ; 




Für jeden XML-RPC-Datentyp werden nun im Folgenden 

• der Parameterwert im XML-Dokument der XML-RPC-Anfrage 

(<vaiue>-Tag), 

• der Rückgabewert im XML-Dokument der XML-RPC-Antwort 
(<vaiue>-Tag) und 

• die Ausgabe des Client 
aufgeführt. 

XML-RPC-Anfrage: 

<i4>1234</i4> 

XML-RPC-Antwort: 

<i4>1234</i4> 

Ausgabe des Client-Programms: 

1234 

XML-RPC-Anfrage: 

<double>123 . 456</double> 

XML-RPC-Antwort: 

<double>123 . 456</double> 
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Ausgabe des Client-Programms: 
123.456 

XML-RPC-Anfrage: 

<boolean>l</boolean> 

XML-RPC-Antwort: 

<boolean>l</boolean> 



Ausgabe des Client-Programms: 

true 

XML-RPC-Anfrage: 

< — A & 0 — > 

XML-RPC-Antwort: 

< — A & 0 — > 

Ausgabe des Client-Programms: 

< — a & o — > 

Wenn wie hier kein Datentyp angegeben ist, wird <string> unter- 
stellt. Die Zeichen <, > und & haben in XML eine Sonderrolle und 
werden daher umcodiert. 

XML-RPC-Anfrage: 

<dateTime . iso8601>20060809T16 : 38 : 34</dateTime. iso8601> 
XML-RPC-Antwort: 

<dateTime . iso8601>20060809T16 : 38 : 34</dateTime. iso8601> 

Ausgabe des Client-Programms: 

Wed Aug 09 16:38:34 CEST 2006 

Die XML-RPC-Anfrage enthält kein <vaiue>-Tag. 

XML-RPC-Antwort: 

<base64>R01GODlhNABYÄPcAAP . . . </base64> 

XML-RPC nutzt das Codierungsverfahren Base64, um Binärdaten 
technisch gesichert in XML-Strukturen zu übertragen. 24 Bit lan- 



Wah rheitswert 



Zeichenkette 



Datum/Zeit 



Binärdaten 
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Array 



Struktur 



ge Gruppen der Binärdaten werden in vier Bitfolgen von jeweils 
6 Bit zerlegt. Diese 6 Bit werden mit Hilfe der US-ASCII-Zeichen 
A — Z, a — z, 0 — 9, +, / und = Codiert (http://www.ietf.org/rfc/ 
rfc2045.txt). 



Ausgabe des Client-Programms: 

Der Client speichert die übertragenen Daten in der Datei test.gif. 



XML-RP C-Anfrage : 

<array> 

<data> 

<value>Das ist ein String</value> 
<value><i4>4 7 1 l</i4x/value> 
</data> 

</array> 



XML-RPC-Antwort: 

<array> 

<data> 

<value>Das ist ein St ringe/ value> 
<valuexint>4711</ intx/value> 
</data> 

</ array> 



Ausgabe des Client-Programms: 

Das ist ein String 
4711 

XML-RP C-Anfrage : 

<struct> 

<member> 

<name>Nachnarne</name> 

<value>Meier</value> 

</rnember> 

<member> 

<narne>Vorname</ name> 
<value>Hugo< / value> 

</member> 

</struct> 



XML-RPC-Antwort: 

<struct> 

<member> 

<narne>Nachnarne</name> 

<value>Meier</value> 

</rnember> 

<member> 

<name>Vorname</ name> 
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<value>Hugo</ value> 
</merriber> 

</struct> 



Ausgabe des Client-Programms: 

Hugo Meier 



Es wird eine Ausnahme vom Typ xmiEpcException ausgelöst, da die 
Methode testFauit nicht existiert. 

Die komplette XML-RPC-Antwort: 

<?xml version="1.0" encoding="UTF-8 n ?> 

<methodRespose> 

<faultxvaluexstruct> 

<rnernber> 

<name>f ault St ring</name> 

<value>No such handler: test.testFault</value> 

</merriber> 

<rnernber> 

<name>f aultCode</ name> 

<value><i4>0</i4x/value> 

</member> 

</ struct x/value></ f ault> 

</iriethodResponse> 



Ausgabe: 

org . apache . xmlrpc . XmlRpcException : No such handler: test. testFauit 



Das Programm MyReporter kann genutzt werden, um die zwischen 
Client und Server ausgetauschten Daten aufzuzeichnen. 

Ein Shutdown hook sorgt für das ordnungsgemäße Schließen der 
Log-Dateien, wenn das Programm mit strg+c beendet wird. 



import java.io.*; 
import java.net.*; 

public dass MyReporter extends Thread { 
private static OutputStream logReguest; 
private static OutputStream logResponse; 
private static ServerSocket srv; 
private static int counter; 

private InputStream fromClient; 
private OutputStream toServer; 

public MyReporter (InputStream frcmClient, OutputStream toServer) { 
this . fromClient = fromClient; 
this. toServer = toServer; 



Ausnahme 



MyReporter 
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public void run() { 
try { 
int c; 

logRequest .write ( ("#" + counter + "\r\n") .getBytes () ) ; 
while ( (c = f rcmClient . read ( ) ) != -1) { 
logRequest. write (c) ; 
toServer .write (c) ; 



catch (IOException e) { } 
try { 

logRequest .write ("\r\n\r\n" .getBytes () ) ; 

1 

catch (IOException e) { } 



public static void main (String [ ] args) { 
int port = Integer .parseint (args [0] ) ; 

String remoteHost = args[l]; 

int remotePort = Integer .parseint (args [2] ) ; 

String filel = args [3] ; 

String file2 = args [4 ] ; 

// ShutdownHook registrieren 

Runtime . getRuntime ( ) . addShutdownHook (new Thread ( ) ( 
public void run() { 
try { 

if (logRequest != null) ( 
logRequest . f lush ( ) ; 
logRequest . close ( ) ; 

} 

if (logResponse != null) { 
logResponse . f lush ( ) ; 
logResponse . close () ; 

} 

if (srv != null) 
srv. close () ; 

} 

catch (IOException e) ( } 

1 

}); 

try { 

logRequest = new FileOutputStream ( filel) ; 
logResponse = new FileOutputStream(file2) ; 
srv = new ServerSocket (port) ; 

while (true) { 

Socket Client = srv.accept () ; 

InputStream frorrClient = dient. getlnputStreamQ ; 
OutputStream toClient = Client. getOutputStream ( ) ; 

Socket socket = new Socket (remoteHost, remotePort) ; 
InputStream fromServer = socket. getlnputStreamQ ; 
OutputStream toServer = socket. getOutputStream ( ) ; 
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counter++; 

// Weiterleitung vom Client an den Server 
(new MyReporter (fromClient, toServer) ) .Start (); 

// Weiterleitung vom Server an den Client 
int c; 

logResponse.write ( ("#" + counter + "\r\n") .getBytes () ) ; 
while ( (c = fromServer.readO ) != -1) { 
logResponse.write (c) ; 
toClient .write (c) ; 

} 

logResponse.write ("\r\n\r\n". getBytes () ) ; 

toClient . f lush ( ) ; 

Client. closeO ; 
socket. closeO ; 



catch (SocketException e) { } 
catch (IOException e) { 
System, err .printin (e) ; 



} 




Bild 6.3 

MyReporter zeichnet 
HTTP-Anfrage und 
-Antwort auf 



Compilieren: 

javac -sourcepath src -cp %XMLRPC_PATH% -d build stc/*. java 



MyReporter starten (Kommando in einer Zeile): 

Start java -cp build MyReporter 40000 localhost 50000 
logRequest . txt logResponse . txt 

logRequest.txt enthält die HTTP -Anfragen und logResponse.txt die 
HTTP -Antworten. 



Server starten: 

Start java -cp build; %XMLRPC_PATH% DatentypTestServer 50000 
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Programm 63 



Bild 6.4: 

Warenkorb als 
Array von Arrays 



Client starten (Kommando in einer Zeile): 

java -cp build; %XMLRPC_PATH% DatentypTestClient http: //localhost : 40000 
int 



6.3 Komplexe Datenstrukturen 

Die Beispiele dieses Kapitels zeigen, wie komplexe Datenstruk- 
turen mit Hilfe einfacher und zusammengesetzter XML-RPC- 
Typen in ein für XML-RPC geeignetes Format transformiert wer- 
den können. 



Die Handler-Klasse Warenkorb verwaltet eine Reihe von Bestellpo- 
sitionen mit den Attributen id, name , preis und menge in einem 
vector-Objekt und bietet die folgenden Methoden an: 

int addPosition(int id, String name, double preis, int menge) 

fügt eine Position ein. 

Object t ] getPositionen ( ) 

liefert alle Positionen des Warenkorbs. Jedes Arrayelement des 
Rückgabewertes ist selbst wieder ein Array, das als Elemente die 
Attribute einer Position enthält. Bild 6.4 zeigt die zugehörige 
XML-Struktur. 



<array> 

<data> 

<value> 

<array> 

<data> 

<value><i4>1000</ i4x/value> 
<value>Hammer</value> 
<value><double>2 . 5</doublex/value> 
<valuexi4>10</ i4x/value> 

</data> 

</array> 

</value> 

<value> 

<array> 

<data> 

<valuexi4>1010</ i4x/value> 
<value>Zange</value> 

<value><double>3 . 99</doublex/value> 
<valuexi4>8</ i4x/value> 

</data> 

</array> 

</value> 

</data> 

</ array> 
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public dass Position { 
private int id; 
private String name; 
private double preis; 
private int menge; 

public Position (int id, String name, double preis, int menge) { 
this.id = id; 
t hi s .name = name; 
this. preis = preis; 
this .menge = menge; 

} 



public Object [] getPositionQ { 
Object [] array = new Object [4]; 
array[0] = id; 
array [1] = name; 
array [ 2 ] = prei s ; 
array [3] = menge; 
retum array; 




iirport java . util . * ; 
public dass Warenkorb { 

private static Vector<Position> korb = new Vector<Position> ( ) ; 

public int addPosition (int id, String name, double preis, 
int menge) { 

korb, add (new Position (id, name, preis, menge)); 
retum 1; 



public Object [] getPositionen ( ) { 
Vector v = new Vector ( ) ; 
for (Position pos : korb) { 
v . add (pos . getPosition ( ) ) ; 

} 

retum v . toArray ( ) ; 



} 



irrport org . apache . xmlrpc . Server . * ; 
import org . apache . xmlrpc . Webserver . * ; 

public dass Server { 

public static void main (String [] args) throws Exception { 
int port = Integer. parse Int (args [0] ) ; 

PropertyHandlerMapping phm = new PropertyHandlerMappingQ ; 
phm . addHandler ( "Warenkorb" , Warenkorb . dass ) ; 



Position 



Warenkorb 



Server 
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Client 



Programm 6.4 



Webserver Webserver = new Webserver (port) ; 
XmlRpcServer Server = Webserver. getXmlRpcServer () ; 
Server . setHandlerMapping (pbm) ; 

Webserver. Start () ; 




import java.util.*; 

inport java.net.*; 

inport org.apache.xmlrpc. Client.*; 

public dass Client { 

public static void main (String args [ ] ) throws Exception { 

URL url = new URL (args [0] ) ; 

XmlRpcClientConfiglrapl config = new XmlRpcClientConfiglmpl () ; 
conf ig . setServerURL (url) ; 

XmlRpcClient dient = new XmlRpcClient ( ) ; 

Client . setConfig (config) ; 

Object [] paramsl = {1000, "Hammer", 2.5, 10}; 

Client . execute ( "Warenkorb . addPosition" , paramsl ) ; 

ObjectH params2 = {1010, "Zange", 3.99, 8); 

Client . execute ( "Warenkorb . addPosition" , params2 ) ; 

Object [ ] params3 = { } ; 

Object [ ] result = (Object [ ] ) dient . execute ( 

"Warenkorb. getPositionen", params3) ; 
for (Object obj : result) { 

Object { ] array = (Object [ ] ) ob j ; 

System. out. printin ("Id: " + (Integer) array[0]); 

System. out .printin ("Name: " + (String) array[l]); 

System. out .printin ("Preis: " + (Double) array[2]); 

System. out .printin ("Menge: " + (Integer) array[3]); 

System. out .printin ( ) ; 




Das Beispiel zeigt auch, dass die Kenntnis der Signatur (mit 
Rückgabetyp) eines Händlers in der Regel alleine nicht ausreicht, 
um das Ergebnis des Methodenaufrufs weiterzuverarbeiten. Zu- 
sätzlich ist die Datenstruktur (Array von Arrays) und ihre Seman- 
tik zu erläutern. 



Der folgende Dienst ermöglicht die Suche nach Personen, die 
auf der Serverseite in einer Datenbank gespeichert sind. Das 
Suchergebnis ist eine Liste von Personen mit den zugehörigen 
Adressen. 
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Personen und Adressen sind in einer MySQL-Datenbank in zwei 
miteinander verknüpften Tabellen gespeichert. 



create table person ( 

persid integer not null auto_increment , 

name varchar (30) , 

vomame varchar (30), 

gebdatum date, 

primary key (persid) 

) 



create table adresse ( 

adressid integer not null aut o_increment , 

persid integer not null, 

plz char (5) , 

ort varchar (30) , 

primary key (adressid) , 

foreign key (persid) references person (persid) 

) 



Die Klasse PersonQuery enthält die Methode 
ArrayList<Person> getPersonen (String name), 

die mit Hilfe des Suchbegriffs name, der auch so genannte Wild- 
card-Zeichen wie % und _ enthalten darf, in der Datenbank nach 
Personen, deren Namen dem Kriterium entsprechen, sucht und 
eine Liste von Person-Objekten zurückliefert. Ein Person-Objekt 
enthält eine Liste von möglicherweise mehreren Adresse- 
Objekten. 



Person 


1 0..* 


Adresse 


name 


plz 




vorname 




ort 


gebdatum 

adressen 







iirport java . util . * ; 
iirport java.text.*; 

public dass Person { 
private String name; 
private String vomame; 
private Date gebdatum; 
private ArrayList<Ädresse> adressen; 



Bild 6.5 

Die Person-Adresse- 
Beziehung 



Person 
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Adresse 



public void setName (String name) { 
this.name = name; 

} 



public String getNameQ { 
retum name; 

} 



public void setVömame (String vomame) { 
this.vomame = vomame; 

} 



public String getVomameO { 
retum vomame; 

} 



public void setGebdatum (Date gebdatum) { 
this.gebdatum = gebdatum; 

} 



public Date getGebdatumO { 
retum gebdatum; 

} 



public void setAdressen (ArrayList<Adresse> adressen) ( 
this.adressen = adressen; 

} 



public ArrayList<Adresse> getAdressen ( ) ( 
retum adressen; 

} 



public void print () { 

System. out. printin ("Name: " + name); 

System, out. printin ("Vorname: " + vomame); 

SimpleDateFormat f = new SimpleDateFormat ("dd.MM.yyyy") ; 
if (gebdatum != null) 

System. out .printin ("Gebdatum: " + f.format (gebdatum) ) ; 
eise 

System. out .printin ("Gebdatum: null") ; 

if (adressen != null) { 

for (Adresse adr : adressen) { 
adr. print () ; 

} 

} 

} 

} 



public dass Adresse { 
private String plz; 
private String ort; 

public void setPlz (String plz) { 
this.plz = plz; 
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public String getPlz ( ) { 
return plz; 

} 



public void setOrt (String ort) { 
this.ort = ort; 

} 



public String getOrt ( ) ( 
return ort; 

} 



public void print ( ) < 

System. out .printin ("PLZ + plz) ; 

System. out. printin ("Ort + ort); 




import java.io.*; 
import java.util.*; 
import java.sql.*; 

public dass PersonQuery ( 
private String url; 
private String user; 
private String password; 

public PersonQuery () { 
try { 

InputStream input = this . getClass ( ) . getResourceAsStream ( 
"dbconnect. properties") ; 

Properties prop = new Properties () ; 
prop . load ( input ) ; 
input. closeO ; 

String driver = prop.getProperty ("driver") ; 
url = prop.getProperty ("url") ; 
user = prop.getProperty ("user") ; 
password = prop.getProperty ("password") ; 

Class . forName (driver) ; 

} 

catch (Exception e) { 

System, err .printin (e) ; 




public ArrayList<Person> getPersonen (String name) { 
ArrayList<Person> personen = new ArrayList<Person> ( ) ; 
Connection con = null; 

try { 

con = DriverManager.getConnection(url, user, password); 
String sql = "select persid, name, vomame, gebdatum " + 
"from person where name like ? Order by name, vomame"; 
PreparedStatement pstmt = con.prepareStatement (sql) ; 
pstmt . setString ( 1 , name ) ; 



PersonQuery 
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ResultSet rs = pstmt.executeQuery () ; 

while ( rs . next ( ) ) { 

Person p = new Person ( ) ; 

int persid = rs.getlnt (1) ; 

p . setName ( r s . getString ( 2 )) ; 

p . setVorname ( rs . getString ( 3 ) ) ; 

p . set Gebdatum ( rs . getDate ( 4 ) ) ; 

p . setÄdressen (getÄdressen (persid, con) ) ; 

Personen . add (p) ; 



rs . close ( ) ; 
pstmt . close ( ) ; 

} 

catch (SQLException e) ( 
System. err .printin (e) ; 

} 

finally { 
try { 

if (con != null) 
con. close () ; 

1 

catch (SQLException e) { } 
return personen; 




private ArrayList<Adresse> getÄdressen (int persid, Connection con) ( 
ArrayList<Ädresse> adressen = new ArrayList<Adresse> () ; 

try { 

String sql = "select plz, ort fron adresse " + 

"where persid = ? Order by plz"; 

PreparedStatement pstmt = con.prepareStatement (sql) ; 

pstmt. setint (1, persid); 

ResultSet rs = pstmt.executeQuery () ; 

while ( rs . next ( ) ) { 

Adresse a = new Adresse ( ) ; 
a. setPlz (rs .getString (1) ) ; 
a. setOrt (rs .getString (2) ) ; 
adressen. add(a) ; 

1 



rs . close ( ) ; 
pstmt . close ( ) ; 

} 

catch (Exception e) { 
System, err .printin (e) ; 

1 

finally { 

return adressen; 
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// Testprogramm 

public static void main (String [] args) throws Exception { 
PersonQuery query = new PersonQuery ( ) ; 

ArrayList<Person> personen = query. getPersonen( n %") ; 
for (Person pers : personen) { 
per s. print () ; 

System. out .print ln ( ) ; 

} 




Die DB-Verbindungsparameter befinden sich in der Datei 
dbconnect. properties. Die Methode getPersonen kann unabhängig 
von XML-RPC getestet werden (main). 



Um das Suchergebnis mittels XML-RPC zum Client zu übertragen, 
muss das Modell aus Bild 6.5 in eine für XML-RPC geeignete 
Struktur transformiert werden. Diese darf nur die Datentypen aus 
Kapitel 6.2 enthalten. 

Diesem Zweck dienen die beiden Hilfsklassen PersonHeiper und 
AdresseHeiper. Sie enthalten jeweils zwei statische Methoden: eine, 
die ein Adresse- bzw. Person-Objekt in eine Map transformiert, und 
eine, die aus einer Map wiederum ein Adresse- bzw. Person-Objekt 
erzeugt. Erstere wird auf der Serverseite, letztere auf der Client- 
seite benötigt. 



iirport java . util . * ; 

public dass AdresseHeiper { 

private final static String PLZ = "plz"; 
private final static String ORT = "ort"; 

public static Map toMap (Adresse adr) { 
Map map = new HashMap ( ) ; 

String plz = adr.getPlz () ; 
if (plz != null) 
map . put (PLZ , plz); 

String ort = adr . getOrt ( ) ; 
if (ort != null) 
map . put (ORT, ort ) ; 

retum map; 



public static Adresse fromMap(Map map) { 
Adresse adr = new Adresse () ; 



AdresseHeiper 



Object obj = map.get (PLZ) ; 
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if (obj != null) 

adr.setPlz ( (String) obj); 

ob j = map . get (ORT) ; 
if (obj != null) 

adr. set Ort ( (String) obj); 

retum adr; 

} 

} 



import java.util.*; 

public dass PersonHelper { 

private final static String NAME = "name"; 
private final static String VORNAME = "vomame"; 
private final static String GEBDATUM = "gebdatum"; 
private final static String ADRESSEN = "adressen"; 

public static Map toMap (Person pers) < 

Map map = new HasbMapO ; 

String name = pers .getName () ; 
if (name != null) 
map. put (NAME, name); 

String vomame = pers .getVomame () ; 
if (vorname != null) 
map. put (VORNAME, vorname); 

Date gebdatum = pers . getGebdatum ( ) ; 
if (gebdatum != null) 

map. put (GEBDATUM, gebdatum); 

ArrayList<Adresse> adressen = pers.getAdressenO ; 
if (adressen != null) { 

Object [] array = new Object [adressen. size ()] ; 
int i = 0; 

for (Adresse adr : adressen) { 

array[i++] = AdresseHelper .toMap (adr) ; 

} 

map. put (ADRESSEN, array); 

} 



retum map; 

} 



public static Person fromMap(Map map) { 
Person pers = new Person ( ) ; 

Object obj = map. get (NAME) ; 
if (obj != null) 

pers . setName ( (String) ob j ) ; 
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obj = map. get (VORNAME) ; 
if (obj != null) 
per s . setVomame ( ( String) ob j ) ; 

obj = map . get (GEBDATUM) ; 
if (obj != null) 
per s.set Gebdatum ( (Date) obj) ; 

obj = map. get (ADRESSEN) ; 
if (obj != null) { 

ArrayList<Adresse> adressen = new ArrayList<Adresse> ( ) ; 
for (Object o : (Object []) obj) { 

adressen . add (AdresseHelper . frcmMap ( (Map) o) ) ; 

} 

pers . setAdressen (adressen) ; 



return pers; 

} 

) 



Der Händler getPersonen der Klasse PersonQueryHandler nutzt die 
PersonQuery-Methode getPersonen und transformiert die Person- 
Objekte. Rückgabewert ist ein Array von Maps. Eine jede Map 
entspricht einer gefundenen Person. Bild 6.6 zeigt das Ergebnis 
einer Transformation. 



iirport java . util . * ; 

public dass PersonQueryHandler { 

private static PersonQuery query = new PersonQuery ( ) ; 

public Object [] getPersonen (String name) { 

ArrayList<Person> personen = query. getPersonen (narne) ; 
Object [] array = new Object [personen. size () ] ; 
if (personen != null) { 
int i = 0; 

for (Person pers : personen) { 

array [ i++ ] = Per sonHelper . toMap (pers ) ; 




PersonQuery- 

Handler 



return array; 
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Bild 6.6: 

Abbildung der 
Person -Adresse- 
Beziehung auf 
Map undArray 



Server 
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import org . apache . xmlrpc . Server . * ; 
import org . apache . xmlrpc . Webserver . * ; 

public dass Server { 

public static void main (String [ ] args) throws Exception { 
int port = Integer .parseint (args [0] ) ; 

PropertyHandlerMapping phm = new PropertyHandlerMapping ( ) ; 
pbm . addHandler ( "personQuery " , PersonQueryHandler . dass ) ; 

Webserver Webserver = new Webserver (port) ; 

XmlRpcServer Server = Webserver . getXmlRpcServer ( ) ; 

Server . setHandlerMapping (phm) ; 

Webserver . Start ( ) ; 




import java.util.*; 

import java.net.*; 

import org . apache . xmlrpc . dient . * ; 

public dass Client { 

public static void main (String args [ ] ) throws Exception { 

URL url = new URL (args [0] ) ; 

String name = args[l]; 

XmlRpcClientConfiglmpl config = new XmlRpcClientConf iglnpl ( ) ; 
config. setServerURL (url) ; 

XmlRpcClient dient = new XmlRpcClient ( ) ; 
dient . setConfig (config) ; 

Object [] params = {name}; 

Object result = dient. execute ("personQuery. getPersonen", params); 
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if (result != null) { 

for (Object obj : (Object []) result) { 

Person pers = PersonHelper . f rcmMap ( (Map) obj); 
pers.print () ; 

System, out . printin ( ) ; 



} 

Hier wird jede Map des von execute gelieferten Arrays in ein 
Person-Objekt transformiert. 



6.4 Dynamische Proxies 

Mit Hilfe so genannter dynamischer Proxies kann die Program- 
mierung des Clients vereinfacht werden. Ein dynamischer Proxy 
ist eine Klasse, die nicht vom Compiler, sondern erst zur Laufzeit 
dynamisch generiert wird. 

Ziel ist es, die entfernte, vom Server implementierte Methode wie 
eine "normale" lokale Methode auf der Clientseite aufzurufen. 

Dazu muss zunächst die Handler-Klasse ein Interface implemen- 
tieren. Dasselbe Interface wird auch vom Client verwendet. 

Wir erläutern die Vorgehensweise anhand des Echo-Dienstes aus 
Programm 6.1. 



public interface Echo ( 

String getEcho (String s) ; 

String getEchoWithDate (String s) ; 

} 



import java.util.*; 
import java.text.*; 

public dass Echolmpl implements Echo { 
public String getEcho (String s) { 
retum s; 

} 



public String getEchoWithDate (String s) { 

SimpleDateFormat f = new SimpleDateFormat ("dd.MM.yyyy HH:rrm:ss") ; 
retum "[" + f.format(new DateO) + "] " + s; 



Programm 6.5 

Interface Echo 



Implementierung 

Echolmpl 
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EchoServer 



EchoClient 



Der beim Aufruf der Methode addHandier benutzte Key für die 
Handler-Klasse muss mit dem voll qualifizierten Namen des In- 
terfaces Cpaket. inter face) übereinstimmen. 



irrport org . apache . xmlrpc . Server . * ; 
import org . apache . xmlrpc . Webserver . * ; 

public dass EchoServer { 

public static void main (String [ ] args) throws Exception { 
int port = Integer. parseint (args[ 0] ) ; 

PropertyHandlerMapping phm = new PropertyHandlerMapping ( ) ; 
phm . addHandier ( "Echo" , Echolmpl . dass ) ; 

Webserver Webserver = new Webserver (port) ; 

XmlRpcServer Server = Webserver . getXmlRpcServer ( ) ; 

Server . setHanderMapping (phm) ; 

Webserver . Start ( ) ; 




Auf der Clientseite wird nun nicht das »niRpcciient-Objekt dient 
direkt zum Aufruf der entfernten Methode benutzt, sondern zu- 
nächst eine Instanz der Klasse 

org . apache . xmlrpc . dient . util . ClientFactory 

wie folgt erzeugt: 

ClientFactory factory = new ClientFactory (dient) ; 



Die ClientFactory-Methode 
Object newlnstance (Class c) 

wird mit dem Interface Echo. dass als Argument aufgerufen. Zu- 
rückgeliefert wird eine Implementierung dieses Interfaces, die 
intern dient nutzt, um die entfernte Methode aufzurufen: 

Echo echo = (Echo) f actory. newlnstance (Echo. class ) ; 

Nun können die Echo-Methoden aufgerufen werden, z.B. 

String s = echo. getEcho ("Hallo") ; 



irrport java.net.*; 

import org . apache . xmlrpc . dient . * ; 

irrport org . apache . xmlrpc . dient . util . ClientFactory; 

public class EchoClient { 

public static void main (String args [ ] ) throws Exception { 

URL url = new URL (args [0] ) ; 

XmlPpcClientConfiglnpl config = new XmlRpcClientConf iglmpl ( ) ; 
config. setServerURL (url) ; 

XmlRpcClient dient = new XmlRpcClient ( ) ; 
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Client . setConf ig (conf ig) ; 

ClientFactory factory = new ClientFactory (dient) ; 
Echo echo = (Echo) factory.newlnstance (Echo. dass) ; 

String s = echo . getEcho ( "Hallo" ) ; 

System. out .printin (s) ; 

String t = echo. getEchoWithDate ("Hallo") ; 

System, out .printin (t) ; 



} 



6.5 Filterung von IP-Adressen 

Mit den folgenden Webserver-Methoden kann der Webserver nur 
bestimmten Clients den Methodenaufruf gestatten bzw. verbie- 
ten. 



void setParanoid (boolean p) 

schaltet die Filterung von IP-Adressen ein (true) bzw. aus 
(faise). Der Webserver akzeptiert standardmäßig Anfragen aller 
IP-Adressen. Mit true wird zunächst keine Client-Verbindung 
akzeptiert. 

void acceptClient (String address) 

fügt die IP-Adresse address in die Liste der akzeptierten IP- Adres- 
sen ein. address kann * enthalten, um einen Nummernkreis an- 
zugeben (z.B. 194.94.124.*). acceptClient wirkt nur, wenn 

setParanoid (true) aufgerufen wurde. 

void denyClient (String address) 

fügt die IP-Adresse address in die Liste der ausgeschlossenen LP- 
Adressen ein. address kann * enthalten, um einen Nummernkreis 
anzugeben (z.B. 194.94.124.*). denyClient wirkt nur, wenn 

setParanoid (true) aufgerufen wurde. 



Das folgende Beispiel zeigt den Einsatz der IP-Filterung. Die Programm 6.6 
Liste cler akzeptierten (accept) bzw. ausgeschlossenen (deny) IP- 
Adressen wird der Property-Datei ip.txt entnommen. 

Beispiel: 

accept: 127.0.0.1 10.108.105.* 10.108.1.51 



222 



6 XML Remote Procedure Calls (XML-RPC) 



EchoServer 



import org . apache . xmlrpc . Server . * ; 
import org . apache . xmlrpc . Webserver . * ; 
import java.util.*; 
irrport java.io.*; 

public dass EchoServer { 

public static void main (String [ ] args) throws Exception { 
int port = Integer .parseint (args [0] ) ; 

PropertyHandlerMapping phm = new PropertyHandlerMapping ( ) ; 
pbm . addHandler ( "echo" , Echo . dass ) ; 

Webserver Webserver = new Webserver (port) ; 

Webserver . setParanoid (true) ; 

FilelnputStream in = new FilelnputStream ( "ip . txt " ) ; 
Properties ip = new Properties ( ) ; 
ip.load(in) ; 
in.close () ; 

String addr = ip.getProperty ("accept") ; 
if (addr != null) { 

StringTokenizer st = new StringTokenizer (addr, " "); 
while ( st . hasMoreTokens ( ) ) 

Webserver . acceptClient (st . next Token ( ) ) ; 

} 

addr = ip . getProperty ( "deny " ) ; 
if (addr != null) { 

StringTokenizer st = new StringTokenizer (addr, " ") ; 
while ( st . hasMoreTokens ( ) ) 

Webserver . denyClient (st . nextToken ( ) ) ; 

} 



XmlRpcServer Server = Webserver . getXmlRpcServer ( ) ; 
Server . setHanderMapping (phm) ; 

Webserver . Start ( ) ; 




Das Client-Programm löst eine Ausnahme aus, wenn die IP- 
Adresse des Client-Rechners nicht zugelassen ist. 



6.6 Einbettung von XML-RPC in Apache Tomcat 

Bisher wurde in allen Beispielen die Klasse Webserver benutzt. Sie 
implementiert einen einfachen HTTP-Server, der zudem XML- 
RPC-Anfragen verarbeiten kann. Bisweilen ist es aus Perform- 
ance- und Sicherheitsgründen erforderlich, die XML-RPC-Ver- 
arbeitung in einen anderen, marktgängigen Webserver zu integ- 
rieren. 



6.6 Einbettung von XML-RPC in Apache Tomcat 
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Wir zeigen diese Integration am Beispiel von Apache Tomcat, Programm 6.7 
der einen Servlet-Container als Ablaufumgebung für Webanwen- 
dungen bietet. Im Folgenden setzen wir den Umgang mit Tomcat 
und Grundlagen zur Servlet-Technologie voraus. 



Die Klasse 

org . apache . xmlrpc . Webserver . XmlRpcServletServer 

ist Subklasse von »niF^cServer und besitzt die folgende Methode: 

void execute ( javax . servlet . http . HttpServletRequest, 
j avax . servlet . http . HttpServletResponse ) 

throws javax. servlet. ServletException, java . io . IOException 

Sie verarbeitet die XML-RPC- Anfrage und liefert die XML-RPC- 
Antwort zurück. 

Diese Methode kann nun sehr einfach in der doPost-Methode 
eines Servlets genutzt werden. 



Die folgende abstrakte Klasse xmlrpc. ÄbstractxmiEpcserviet dient als 
universelle Basisklasse für eigene Servlets. 



package xmlrpc; 

import java. io.*; 

import javax . servlet . * ; 

import javax . servlet . http . * ; 

import org. apache. xmlrpc.*; 

import org . apache . xmlrpc . Webserver . * ; 

import org . apache . xmlrpc . Server . * ; 

public abstract dass ÄbstractXmlRpcServlet extends HttpServlet { 
private XmlRpcServletServer Server; 

public final void init (ServletConfig config) 
throws ServletException { 

super . init (config) ; 
try { 

PropertyHandlerMapping phm = new P ropert yHandlerMapping ( ) ; 
addHandlers (phm) ; 

Server = new XmlRpcServletServer ( ) ; 

Server . setHandlerMapping (phm) ; 

} 

catch (XmlRpcException e) { 

throw new ServletException (e) ; 



AbstractXmlRpc- 

Servlet 
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EchoServlet 



web.xml 



public abstract void addHandlers (PropertyHandleriyiapping phm) 
throws )ünlRpcException; 

public final void doPost (HttpServletRequest request, 
HttpServletResponse response) throws ServletException, 
IOException { 

Server . execute ( request , response ) ; 

} 

} 



Zur Demonstration ist die Klasse echo.EchoServiet von dieser ab- 
strakten Klasse abgeleitet. Sie implementiert die Methode 
addHandlers. Somit haben Subklassen nur noch die Aufgabe, die 
geforderten Händler zu registrieren. 



package echo; 

irrport org . apache . xmlrpc . * ; 
irrport org . apache . xmlrpc . Server . * ; 
irnport xmlrpc. ÄbstractXmlRpcServlet; 

public dass EchoServlet extends AbstractXmlRpcServlet { 
public void addHandlers (PropertyHandleriyiapping phm) 
throws XmlRpcException { 

phm . addHandler ( " echo " , Echo . dass ) ; 




Die hier verwendete Klasse echo. Echo entspricht der in Programm 
6.1 verwendeten Klasse. Der einzige Unterschied ist, dass eine 
package-Klausel hinzugekommen ist. 

Die übersetzten Klassen AbstractXilLRpcServlet, EchoServlet und Echo 
gehören gemäß ihrer Paketstruktur in das Verzeichnis classes 
unter WFB-INF. Die für XML-RPC erforderlichen JAR-Dateien 
müssen in das Verzeichnis Hb unter WEB-INF kopiert werden. 



Die Deskriptordatei web.xml hat den folgenden Inhalt: 

<?xml version="1.0" encoding=" ISO-885 9-1 " ?> 

<web-app xmlns="http : / / java . sun . com/ xml/ ns/ j2ee " 

xmlns : xsi="http : / /www . w3 . org/ 2001/XMLSchema-instance" 

xsi : schemaLocation="http : //java . sun . com/ xml/ ns/ j2ee web-app_2_4 . xsd" 

version="2 . 4"> 



<servlet> 

<servlet-name>EchoServlet</servlet-name> 
<servlet-class>echo .EchoServlet</ servlet-class> 
</servlet> 
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<servlet-mapping> 

<servlet-name>EchoServlet</servlet-name> 
<url-pattem>/servlet/echo</url-pattem> 
</ servlet^napping> 

</web-app> 



Zum Schluss muss diese Webanwendung Tomcat bekannt ge- 
macht werden. Hierzu muss die Datei xmlrpc.xml mit dem 
<context>-T ag ( path="/xmlrpc ") in das Verzeichnis 

<CATALINA_HCME>\conf\Catalina\localhost 

kopiert werden. 

Nun kann Tomcat gestartet werden. 

Der Client Echoclient entspricht der gleichnamigen Klasse in Pro- 
gramm 6.1. 



Apache XML-RPC unterstützt auch die Authentifizierung mit Be- Basic 
nutzername und Passwort. XML-RPC nutzt das HTTP -Verfahren Authentication 
Basic Authentication (http://www.ietf.org/rfc/rfc2617.txt). 

Die Klasse xmiE^cciientconfiginpi bietet hierzu die Methoden 

void setBasicUserName (String user) und 
void setBasicPassword ( String password). 

user und password werden nach dem Base64-Verfahren codiert 
(siehe Kapitel 6.2) und in einem Basic Authentication Header 
per HTTP an den Server geschickt. Zu beachten ist, dass es sich 
hierbei um keine echte Verschlüsselung von Benutzername und 
Passwort mit dem Ziel der Geheimhaltung handelt. 

Beispiel: Ist der User "hugo" und das Passwort "oguh", so lautet 
der HTTP-Header: 

Authorization: Basic aHVnbzpvZ3Vo 

"aHVnbzpvZ3vo" wird nach dem Base64-Verfahren auf der 
Serverseite zu "hugo: oguh" decodiert. 



Programm 6.8 

EchoClient 

public dass EchoClient { 

public static void main (String args[]) throws Exception { 

URL url = new URL(args[0] ) ; 

String user = args[l]; 

String password = args[2]; 

XmlRpcClientConfiglmpl config = new XmlRpcClientConfiglmpl () ; 
config . setServerUKL (url) ; 
config . setBasicUserName (user) ; 
config . setBasicPassword (password) ; 



import java.net.*; 

import org.apache.xmlrpc. dient.*; 
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web.xml 



XmlRpcClient dient = new XmlRpcClient ( ) ; 

Client . setConfig (conf ig) ; 

Object [ ] params = { "Hallo" } ; 

String s = (String) dient. execute ("echo.getEcho", params) ; 
System out .printin (s) ; 

String t = (String) dient . execute ( 

"echo.getEchoWitbDate", params) ; 

System. out. printin (t) ; 




Tomcat muss für die Authentifizierung konfiguriert werden. Die 
Deskriptordatei web.xml ist wie folgt zu ergänzen: 

<?xml version="1.0" encoding=" ISO-885 9-1 " ?> 

<web-app xmlns="http : / / java . sun . com/ xml/ ns/ j2ee" 

xmlns :xsi="http: //www. w3 . org/2001/XMLSchema-instance" 

xsi : schemaLocation="http : //java . sun . com/ xml/ ns/ j2ee web-app_2_4 . xsd" 

version="2 . 4"> 



<servlet> 

<servlet-name>EchoServlet</servlet-name> 
<servlet-class>echo .EchoServlet</ servlet-class> 
</ servlet> 

<servlet-mapping> 

<servlet-name>EchoServlet</servlet-name> 
<url-pattem>/ servlet /echo</url-pattern> 

</ servlet ^napping> 

<security-constraint> 

<web-resource-collection> 

<web-resource-name>echo</web-resource-name> 
<url-pattem>/servlet/ echo</ url-pattem> 
</web-resource-collection> 

<auth-constraint> 

<role-name>user</role-name> 

</auth-constraint> 

</ security-constraint> 

<login-config> 

<auth-method>BASIC</auth-method> 
<realm-name>Test</ realm-name> 

</ login-conf ig> 

<security-role> 

<role-name>user</role-name> 

</ security-role> 

</web-app> 
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Die zugriffsberechtigten User werden der Einfachheit halber in 
die XML-Datei 

<CATALINA_HCME>\conf\tcmcat -users . xml 

eingetragen: 

<tomcat-users> 

<role rolename="user"/> 

<user usemame="hugo n password =,, oguh n roles= n user"/> 

</ tomcat-users> 



Zusätzlich kann eine Verschlüsselung mit Server-Authenti- SSL 
fizierung genutzt werden. Secure Socket Layer (SSL) ist ein weit 
verbreitetes Verfahren, das auf Public-Key-Verschlüsselung ba- 
siert. 



Zur Nutzung von SSL müssen Server und Client vorbereitet wer- Programm 6.9 
den. Der Quellcode der Programme ist der gleiche wie in Pro- 
gramm 6.8. 



Zunächst wird ein Schlüsselpaar (private key, public key) mit Konfiguration 
einem "self-signed" Zertifikat erzeugt. Dies reicht für Testzwecke des Servers 
aus. Anschließend wird das Zertifikat (mit dem öffentlichen 
Schlüssel des Servers) exportiert. 



Wir benutzen hierzu das JDK-Tool keytool. createKeystore 

keytool -genkey 

-dnaire "CN=localhost, OU=FB 08, 0=Hochschule Niederrhein, C=DE" 

-alias tcmcat -keyalg RSA -validity 60 -keystore keystore 
-keypass tomcat -storepass tcmcat 

keytool -export -rfc -alias tomcat -file tomcat. cer 
-keystore keystore -storepass tcmcat 

(Die beiden Kommandos sind im DOS-Fenster jeweils in einer 
Zeile einzugeben.) 



In <CATALiNA_HCME>\conf\server.xmi wird nun ein Konnektor für den server.xml 

Port 8443 eingerichtet: 

<Connector port= n 8443" maxHttpHeaderSize="8192" 

maxThreads="150" minSpareThreads= n 25" mxSpareThreads=" 75 " 
enableLookups="false" disableüploadTimeout= n true" 
acceptCount="100" scheme="https" secure="true" 
clientAuth="false" sslProtocol= n TLS" 
keystoreFile=" <Verzeichnis>/keystore " 
keystorePass="tomcat n /> 
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Konfiguration 
des Client 


Auf der Clientseite wird das Zertifikat in den Speicher 
truststore importiert. 


createTruststore 


keytool -import -noprompt -alias tcmcat -file tomcat.cer 
-keystore truststore -storepass Catalina 

(Das Kommando ist im DOS-Fenster in einer Zeile einzugeben.) 


Aufruf des Client 


Angaben zum Speicherort des Zertifikats werden beim Aufruf des 
Client-Programms als Systemeigenschaften mitgegeben: 

java -D javax . net . ssl .trustStore=truststore 
-D javax . net . ssl . trustStorePassword=catalina 
-cp build; %XMLRPC_PATH% EchoClient 
https://localhost:8443/xmlrpc/servlet/echo hugo oguh 

(Das Kommando ist im DOS-Fenster in einer Zeile einzugeben.) 

Zu beachten ist, dass statt http hier https (HTTP over SSL) an- 
zugeben ist. 


Programm 6.10 


6.7 Nutzung einer Erweiterung in Apache XML-RPC 

In diesem Kapitel gehen wir auf die in Kapitel 6.1 angesproche- 
ne Erweiterung in Apache XML-RPC 3-0 ein. Dazu muss auf bei- 
den Seiten (Client und Server) Apache XML-RPC zum Einsatz 
kommen. 

Da Apache XML-RPC in der Voreinstellung die offizielle XML- 
RPC-Spezifikation erfüllt, müssen für die Nutzung der nicht dem 
Standard entsprechenden Erweiterung sowohl der Client als auch 
der Server besonders konfiguriert werden. Hierzu ist die Eigen- 
schaft enabledForExtensions ZU Setzen. 

Programm 6.10 zeigt, dass Klassen, die das Interface java. io. 
Seriaii zabie implementieren, als Datentypen für XML-RPC- 
Handler verwendet werden können. Zudem nutzen wir die Pro- 
grammiertechnik aus Kapitel 6.4 ("Dynamische Proxies"). Die 
fachliche Aufgabenstellung wurde aus Programm 6.3 übernom- 
men. 


Klasse Position 


public dass Position implements java.io.Serializable { 
private int id; 
private String narne; 
private double preis; 
private int menge; 

public Position () { } 

public Position (int id, String name, double preis, int menge) { 
this.id = id; 
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this.name = name; 
this. preis = preis; 
this. menge = menge; 



public int getldQ { 
retum id; 

} 



public void setld(int id) { 
this.id = id; 

} 



public String getNameO { 
retum name; 

} 



public void setName (String name) { 
this.name = name; 

} 



public double getPreis ( ) { 
retum preis; 

} 



public void setPreis (double preis) { 
this. preis = preis; 

} 



public int getMengeQ { 
retum menge; 

} 



public void setMenge (int menge) { 
this. menge = menge; 

} 



import java.util.*; 

public interface Warenkorb { 
int addPosition (Position pos); 
Vector<Position> getPositionen () ; 

} 



import java.util.*; 

public dass Warenkorblmpl implements Warenkorb { 

private static Vector<Position> korb = new Vector<Position> ( ) ; 

public int addPosition (Position pos) { 
korb. add (pos) ; 
retum 1; 



Interface 

Warenkorb 



Implementierung 

Warenkorblmpl 
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Server 



Client 



public Vector<Position> getPositionen ( ) { 
retum korb; 

} 



Mit Hilfe der Klasse 

org . apache . xmlrpc . Server . XmlRpcServerConfiglmpl 

kann ein xmiRpcServer-Objekt konfiguriert werden. 



Die XmlRpcServerConfiglmpl-Methode 

void setEnabledForExtensions (boolean ext) 

aktiviert (true) bzw. deaktiviert (false) die Erweiterungen. 

Mit dem Aufruf der xmiRpcServer-Methode setconfig wird die Kon- 
figuration config für den Server gesetzt: setconfig (config) . 



irrport org . apache . xmlrpc . Server . * ; 
import org . apache . xmlrpc . Webserver . * ; 

public dass Server { 

public static void main (String [ ] args) throws Exception { 
int port = Integer. parseint (args[ 0] ) ; 

PropertyHandlerMapping phm = new P ropert yHandlerMapping ( ) ; 
phm . addHandler ( "Warenkorb" , Warenkorblmpl . dass) ; 

Webserver Webserver = new Webserver (port) ; 

XmlRpcServer Server = Webserver . getXmlRpcServer ( ) ; 
XmlRpcServerConfiglmpl config = new XmlRpcServerConf iglmpl ( ) ; 

config. setEnabledForExtensions (true) ; 

Server . setConfig (config) ; 

Server . setHandlerMapping (phm) ; 

Webserver . Start ( ) ; 




Die XmlRpcClientConfiglmpl-Methode 

void setEnabledForExtensions (boolean ext) 
aktiviert (true) bzw. deaktiviert (false) die Erweiterungen. 



import java.util.*; 

import java.net.*; 

irrport org . apache . xmlrpc . dient . * ; 

import org . apache . xmlrpc . dient . ut il . ClientFactory ; 



public dass Client { 

public static void main (String args[]) throws Exception { 

URL url = new URL (args [0] ) ; 

XmlRpcClientConf iglrrpl config = new XmlRpcClientConf iglrrpl () ; 
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config . setServerURL (url) ; 

config.setEnabledForExtensions (true) ; 

XmlRpcClient dient = new XmlRpcClient ( ) ; 
dient . setConfig (config) ; 

ClientFactory factory = new ClientFactory (dient) ; 

Warenkorb korb = (Warenkorb) factory .newlnstance (Warenkorb. dass) ; 

Position posl = new Position (1000, "Hammer", 2.5, 10); 
korb.addPosition(posl) ; 

Position pos2 = new Position (1010, "Zange", 3.99, 8); 
korb.addPosition(pos2) ; 

Vector<Position> v = korb.getPositionen () ; 
for (Position pos : v) { 

System.out.printlnC'Id: " + pos . getld ( ) ) ; 

System. out .println( "Name: " + pos.getName () ) ; 

System. out .printin ("Preis: " + pos . getPreis ( ) ) ; 

System. out. printin ( "Menge : " + pos . getMenge ( ) ) ; 

System. out .printin ( ) ; 




6.8 Aufgaben 

1. Entwickeln Sie einen XML-RPC-Server, der an ihn über- 
mittelte Nachrichten (Username, Text) in einer Datei spei- 
chert. 

2. Entwickeln Sie einen XML-RPC-Server, der Adressen in einer 
Datenbank verwaltet: 

id nachname vorname telefon email 

1 Meier Hugo 02102/112233 h.meier@xyz.de 

Der Client kann 

• einen Eintrag erfassen: 

boolean add (String nachname, String vorname, String telefon, 
String email) 

• einen Eintrag löschen: 

boolean remove(int id) 

• alle Einträge auflisten: 

Object [ ] getAll ( ) 

• Einträge suchen: 

Object [] lookup (String spalte, String muster) 
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Die einzelnen Funktionen sollen parametergesteuert (Auf- 
rufparameter) abgerufen werden können: 



Funktion 


Parameter 


getAll 


<url> 


remove 


<url> <id> 


lookup 


<url> <spalte> <muster> 


add 


<url> <nachname> <vomame> <telefon> <email> 



3. Entwickeln Sie als Ergänzung zur Aufgabe 2 einen Client 
mit grafischer Oberfläche, mit dem nach Adressen gesucht 
werden kann ( lookup ). 



Bild 6.7: 

Adressen suchen 




4. Ein XML-RPC-Server soll Eintritts- und Austrittszeiten in 
einer Datenbank verwalten: 

id beginn 

hugo 2006-05-13 08:01:43 

hugo 2006-05-13 13:10:12 

hugo 2006-05-13 16:25:11 

Der Client kann 

• Beginn und Ende zu einer ID erfassen: 

String set Time (String id) 

• die Gesamtzeit zu einer ID abfragen: 

String getTotalTime (String id) 



ende 

2006-05-13 12:15:43 
2006-05-13 15:45:02 
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5. Diese Aufgabe setzt PHP -Grundkenntnisse voraus. Für die 
vier in Aufgabe 2 implementierten XML-RPC-Dienste add, 
remave, getAii und lookup soll eine Web-Oberfläche mit Hilfe 
von PHP realisiert werden. Die einzelnen PHP-Skripte im- 
plementieren also XML-RPC-Clients und generieren HTML- 
Seiten zur Anzeige der Ergebnisse. 

Zur Lösung dieser Aufgabe kann beispielsweise die XML- 
RPC-Library für PHP unter der Adresse 

http : //sourceforge . net/pro jects/phpxmlrpc/ 

heruntergeladen werden. Die Include-Datei xmlrpc.inc ent- 
hält den Code für die Client-Funktionalität. 




7 Entfernter Methodenaufruf mit RMI 



In diesem Kapitel stellen wir ein System vor, das die Kom- 
munikation zwischen Objekten, die auf verschiedenen Rechnern 
erzeugt sind, ermöglicht. Im Gegensatz zur XML-RPC-Spezi- 
fikation aus Kapitel 6 sind die Datentypen der Methodenaufruf- 
parameter nicht eingeschränkt. Neben (fast) beliebigen Objekten 
kann auch das Verhalten (Bytecode) übertragen werden, so dass 
flexible Anwendungen realisiert werden können. Allerdings muss 
sowohl der Client als auch der Server in Java programmiert sein. 

7.1 Remote Method Invocation 

Das Protokoll Remote Method Invocation (RMI) setzt auf TCP/IP 
auf und verbirgt die Details einer Netzverbindung. RMI hat fol- 
gende Eigenschaften: 

• Mit RMI können Methoden für Objekte aufgerufen werden, 
die von einer anderen virtuellen Maschine (JVM) erzeugt und 
verwaltet werden - in der Regel auf einem anderen Rechner. 

• Für den Entwickler sieht der entfernte Methodenaufruf wie 
ein ganz normaler lokaler Aufruf aus. 

• Entfernt aufrufbare Methoden werden in einem Interface 
deklariert. Nur hierüber kann der Client mit einem entfernten 
Objekt kommunizieren. Das Interface stellt einen so genann- 
ten Vertrag zwischen Client und Server dar. 

• Netzspezifischer Code, der die Codierung und Übertragung 
von Aufrufparametern und Rückgabewerten ermöglicht wird 
ab Java SE 5.0 dynamisch zur Laufzeit generiert. 

• Um für den ersten Aufruf einer entfernten Methode eine "Re- 
ferenz" auf das entfernte Objekt, das diese Methode anbietet, 
zu erhalten, kann der Client einen so genannten Namens- 
dienst (Registry) nutzen. 

• RMI bietet Mechanismen sowohl für die Übertragung von 
Objekten als auch für die Übertragung und das Laden des 
Bytecodes der zugehörigen Klassen, falls diese lokal nicht 
vorhanden sind. 

• RMI ist eine rein Java-basierte Lösung, cl.h. Client und Server 
müssen in Java programmiert sein. 



Mit Hilfe eines Namensdienstes können Dienste zentral veröffent- 
licht werden, sodass Clients diese über ein Netz finden und nut- 
zen können. Namensdienste ordnen den Adressen von Ressour- 
cen (beispielsweise entfernten Objekten) eindeutige Namen zu. 



Eigenschaften 
von RMI 



Begriffserklä ru ng 
Namensdienst 
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Bild 7.1 

RMI-Anwendung 



Programm 7.1 



Remote Interface 



Die Adresse einer Ressource enthält alle Informationen, die ein 
Client braucht, um mit der Ressource zu kommunizieren. Um 
eine "Referenz" auf die gewünschte Ressource zu erhalten, über- 
gibt der Client dem Namensdienst den Namen, unter dem die 
Ressource angemeldet ist. Als Ergebnis erhält er die Referenz, mit 
der nun eine Verbindung zur Ressource aufgebaut werden kann. 

Bild 7.1 zeigt den allgemeinen Fall einer mit RMI realisierten 
Client-Server- Anwendung. 



Rechner B 




Der Client erhält über die Registry eine "Referenz" auf ein ent- 
ferntes Objekt, das der Server vorher dort registriert hat. Für 
dieses Objekt ruft der Client eine Methode auf. Gegebenenfalls 
kann das RMI-System auch einen Webserver nutzen, um Byteco- 
de für Objekte vom Server zum Client bzw. umgekehrt zu über- 
tragen. 

Die Zusammenhänge, Begriffe und die erforderlichen Klassen 
und Methoden zur Entwicklung einer RMI-Anwendung werden 
nun im Folgenden anhand eines ersten Beispiels schrittweise 
erläutert. 



Programm 7.1 zeigt die Implementierung eines Echo-Dienstes. 



Das Remote Interface definiert die Sicht des Client auf das ent- 
fernte Objekt. Dieses Interface enthält die Methoden, die für 
dieses Objekt entfernt aufgerufen werden können. 

Ein Remote Interface ist von dem Interface 

java . rmi . Remote 

abgeleitet: Remote dient dazu, Interfaces zu kennzeichnen, deren 
Methoden entfernt aufgerufen werden sollen. Remote muss von 
allen Interfaces erweitert werden, die entfernte Methoden 
deklarieren. 



7.1 Remote Method Invocation 
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java. rmi. RemoteException ist von java.io.IOException abgeleitet lind 
ist Superklasse einer Reihe von Ausnahmen, die beim Aufruf 
einer entfernten Methode bei Netz- bzw. Protokollfehlern ausge- 
löst werden können. Jede Methode eines von Remote abgeleiteten 
Interfaces ( Remote Interface) muss diese Klasse in der throws- 
Klausel aufführen. 



iirport java . rmi . *; 

public interface Echo extends Remote { 

String getEcho (String s) throws RemoteException; 

} 



Jedes Objekt, dessen Klasse ein Remote Interface implementiert, 
ist ein so genanntes entferntes Objekt C Remote Object), d.h. es 
implementiert die vorgeschriebenen entfernt aufrufbaren Me- 
thoden. Diese Methoden und die Konstruktoren müssen Remote- 
Exception in der throws-Klausel enthalten. 



Damit eine Verbindung zwischen Client und Server aufge- 
nommen werden kann und Methoden des Objekts entfernt auf- 
gerufen werden können, muss das entfernte Objekt exportiert 
und damit remote-fähig gemacht werden. 

Dies geschieht durch Ableiten von der Klasse 

java . rmi . Server . UnicastRemoteOb ject. 

Bei Erzeugung des entfernten Objekts wird der Konstruktor die- 
ser Superklasse aufgerufen, der das Objekt exportiert. Das expor- 
tierte Objekt kann nun über TCP/IP eingehende Nachrichten 
erhalten. 



Es hat sich die Konvention durchgesetzt, dass die Implementie- 
rung des Interfaces Xxx in der Klasse Xxxinpi erfolgt. 



iirport java. rmi.*; 
import java. rmi. Server.*; 

public dass Echolmpl extends UnicastRemoteÖbject implements Echo { 
public Echolmpl () throws RemoteException { } 

public String getEcho (String s) throws RemoteException { 
retum s; 

} 



RemoteException 



Remote Interface 
Echo 



Remote Object 



Exportieren 



Implementierung 
des Remote 
Interface: Echolmpl 
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Stilb und Skeleton 



Bild 72: 

Aufruf einer 
entfernten Methode 



Bild 73: 

Remote Reference 



Die Codierung bzw. Decodierung der Aufrufparameter und 
Rückgabewerte von Methodenaufrufen und die Übermittlung der 
Daten zwischen Client und Server wird vom RMI-System und 
von generierten Klassen, beim Client Stilb und beim Server Skele- 
ton genannt, geregelt (siehe Bild 7.2). 



Client Server 




Java Remote Method Protocol (JRMP) 



Ein Stub-Objekt fungiert als lokaler Stellvertreter (Proxy) des 
entfernten Objekts. Ein Stub implementiert dasselbe Remote 
Interface, das auch die Klasse des entfernten Objekts imple- 
mentiert. 



Client 






7.1 Remote Method Invocation 
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Ein Client erhält Zugriff auf ein entferntes Objekt durch eine so 
genannte entfernte Referenz (Remote Reference). Diese wird 
beim Erzeugen des lokalen Stub-Objekts bereitgestellt. Sie kap- 
selt Informationen, die für den Zugriff auf das entfernte Objekt 
benötigt werden. Der Client ruft eine Methode des Stub-Objekts 
auf, die dann für den Methodenaufruf des entfernten Objekts auf 
der Serverseite sorgt (siehe Bild 7.3). Kurz gesagt steht also eine 
entfernte Referenz in Form eines Stub-Objekts zur Verfügung. 



Das Java Remote Method Protocol (JRMP) wird vom Stub genutzt, 
um mit dem Server zu kommunizieren. Es liegt in zwei Versio- 
nen vor: 1.1 und 1.2. 

• Version 1.1 kommuniziert mit einem Skeleton (wird genutzt 
für Clients, die unter JDK 1.1 laufen), 

• Version 1.2 benötigt keine Skeleton-Klasse. 



Das Tool rmic erzeugt Stubs und Skeletons aus den kompilierten 
Klassen, die die Implementierung des Remote Interface enthal- 
ten. 

• rmic -vl.l ... erzeugt Stubs und Skeletons für JRMP 1.1, 

• rmic -vl.2 ... erzeugt nur Stubs für JRMP 1.2. 



Ab Java SE 5.0 werden Stubs zur Laufzeit dynamisch generiert, 
sodass rmic nicht mehr gebraucht wird, rmic steht aber weiter- 
hin zur Verfügung, um Clients unter früheren Java-Versionen zu 
unterstützen. Der Aufruf von rmic ohne weitere Option verhält 
sich wie rmic -vl.2 ... Um Stubs und Skeletons, die mit JRMP 
1.1 und 1.2 kompatibel sein sollen, zu generieren, muss 
rmic -vcompat . . . genutzt werden. 



Die Klasse Echoserver (siehe unten) erzeugt ein entferntes Objekt 
vom Typ Echoinpi und registriert dieses bei einem Namensdienst 
(Registry). 



Das vom SDK bereitgestellte Programm rmiregistry stellt einen 
einfachen Dienst zur Verfügung, der es dem Client erlaubt, eine 
erste Referenz auf ein entferntes Objekt als Einstiegspunkt zu 
erhalten. Weitere Referenzen auf andere entfernte Objekte kön- 
nen von hier aus dann anwendungsspezifisch, z.B. als Rückga- 
bewerte von entfernten Methodenaufrufen, geliefert werden. 

Jeder Eintrag in der Registry besteht aus einem Namen und einer 
Objektreferenz. 



Remote Reference 



Generierung von 
Stub und Skeleton 



Registry 
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Der Name hat die Form eines URL: 

/ /host : port /Dienstname 

Bis auf Dienstname können alle Bestandteile entfallen. Der Rech- 
nername ist in diesem Fall locaihost und die Portnummer 1099- 

Soll für die Registry eine andere als die standardmäßig vorgese- 
hene Portnummer 1099 benutzt werden, so muss sie als Aufruf- 
parameter beim Start von rmiregistry angegeben werden. 


Naming 


Die Klasse java. rmi. Naming wird von Clients und Servern benutzt, 
um mit der Registry zu kommunizieren. 


bind 


static void bind (String name, Remote obj) 
throws java . rmi . Al readyBoundExcept ion , 

java . net . Malf ormedURLException, java . rmi . RemoteException 

registriert einen Eintrag für ein entferntes Objekt, name wird an obj 
gebunden. AireadyBoundException wird ausgelöst, wenn name bereits 
eingetragen ist. MaiformedURLException wird ausgelöst, wenn der 
Aufbau von name nicht korrekt ist. 


rebind 


static void rebind (String name, Remote obj) 

throws java. net. MaiformedURLException, java. rmi. RemoteException 

registriert einen Eintrag für ein entferntes Objekt, name wird an obj 
gebunden. Besteht bereits ein Eintrag zu diesem Namen, so wird 
der bestehende Eintrag überschrieben. MaiformedURLException wird 
ausgelöst, wenn der Aufbau von name nicht korrekt ist. 


unbind 


static void unbind (String name) 

throws java . rmi . NotBoundException, 

java . net . MaiformedURLException, java . rmi . RemoteException 
entfernt den Eintrag ZU name. NotBoundException wird ausgelöst, 
wenn ZU name kein Eintrag vorhanden ist. MaiformedURLException 
wird ausgelöst, wenn der Aufbau von name nicht korrekt ist. 

Diese drei Naming-Methoden können nur auf dem Rechner ausge- 
führt werden, auf dem auch der Namensdienst läuft. 


Der Server: 
EchoServer 


import java.rmi.*; 
public dass EchoServer { 

public static void main (String args [ ] ) throws Exception { 
Remote remote = new Echolmpl ( ) ; 

Naming . rebind ( " echo " , remote ) ; 

System . out . print ln ( "EchoServer gestartet ..."); 
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Das RMI-System sorgt dafür, dass der Server läuft, auch wenn die 
Ausführung der main-Methode beendet ist. 



import java.rmi.*; 
public dass EchoClient { 

public static void main (String args[]) throws Exception { 
if (args.length != 2) { 

System. err .printin ("java EchoClient <host> <text>"); 
System. exit (1) ; 

} 



String host = args[0]; 

String text = args[l]; 

Echo remote = (Echo) Naming.lookupC'//" + host + "/echo") ; 
String received = remote. getEcho (text) ; 
System.out.println(received) ; 



} 



Mittels der Naming-Methode lookup erhält der Client das Stub- 
Objekt zum entfernten Objekt, das unter dem Namen "echo" in 
der Registry eingetragen ist. 

static Remote lookup (String name) 

throws java . rmi . NotBoundException, 

j ava . net . Mal f ormedURLExcept i on , java . rmi . RemoteException 

liefert die Referenz auf das Stub-Objekt für das unter name einge- 
tragene entfernte Objekt. ivuiformedURLException wird ausgelöst, 
wenn der Aufbau von name nicht korrekt ist. NotBoundException wird 
ausgelöst, wenn zu name kein Eintrag vorhanden ist. 

Aufruf der Registry: 

Start /Dbuild rmiregistry 

oder 

Start /Dbuild rmiregistry -J-D java. rmi. Server. logCalls=true 

(Dies bewirkt, dass der Kommunikationsfluss zwischen Client 
und Server protokolliert wird.) 



Aufruf des Servers: 

Start java -cp build EchoServer 



Aufruf des Client: 



Der Client: 
EchoClient 



lookup 



Test 



java -cp build EchoClient localhost Hallo 
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policy.txt 



LocateRegistry 



Aufrufparameter 
und Rückgabewert 



Übertragungsregeln 



Um sich gegen Einschleusen schädlichen Codes in den Client zu 
schützen, kann die Ausführung von einem Security Manager 
kontrolliert werden. Hierzu muss eine Policy-Datei mit bei- 
spielsweise folgendem Inhalt angelegt werden: 



grant { 

permission java. net. SocketPermission "*:1024-", "connect"; 

}; 



Der Client ist dann wie folgt aufzurufen (in einer Zeile ein- 
zugeben): 

java -Djava. Security .manager Djava. Security .policy=policy.txt 
-cp build EchoClient localhost Hallo 

Client und Server können natürlich auch auf unterschiedlichen 
Rechnern installiert und getestet werden. 



rmiregistry startet die Registry auf einem Rechner, die dann für 
mehrere RMI-Server genutzt werden kann. Eine individuelle Re- 
gistry kann aber auch innerhalb des Servers gestartet werden. 
Dazu Steht die Klasse LocateRegistry im Paket java.rmi. 
registry zur Verfügung. 

Die Methode 

static Registry createRegistry (int port) 
throws java . rmi . RemoteException 

erzeugt eine Registry die auf dem Port port Anfragen akzeptiert. 



Die Aufrufparameter und der Rückgabewert einer entfernten 
Methode können von einem einfachen Datentyp, Referenzen auf 
"normale" lokale Objekte oder Referenzen auf entfernte Objekte 
sein. 



Für entfernte Methoden gelten die folgenden Übertragungsregeln: 

Werte von einfachem Datentyp (z.B. int, double) werden wie bei 
lokalen Methodenaufrufen hy value übertragen. 

Lokale Objekte werden serialisiert, übertragen und vom 
Server deserialisiert. Dafür sorgen Stub und Skeleton. Lokale 
Objekte werden, anders als beim lokalen Methodenaufruf, als 
Kopie by value übertragen. Diese Objekte müssen also das Inter- 
face java . io . Serializable implementieren. 

Exportierte entfernte Objekte werden by reference übertragen, 
d.h. es werden die Stub-Objekte, nicht Kopien der Originale 
übertragen. 



7.3 Transport by reference 
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Die folgende Tabelle fasst die Regeln zusammen: 



Typ 


lokale Methode 


entfernte Methode 


einfacher Typ 


by value 


by value 


Objekt 


by reference 


by value 
(Serialisierung) 


entferntes Objekt 


by reference 


by remote reference 
(Stub-Objekt) 



7.2 Dienstauskunft 

Das folgende Programm gibt eine Liste aller in der Registry 
gebundenen Namen aus. 

Die Naming-Methode 

static String [] list (String name) 

throws java . rmi . RemoteException, java . net .Malf ormedDRLException 

liefert ein Array von Namen, die an entfernte Objekte gebunden 
sind, name spezifiziert die Registry, also z.B. "//locaihost". 



import java. rmi. *; 
public dass ListRegistry { 

public static void main (String args[]) throws Exception { 
String registryName = args[0]; 

String list[] = Naming. list (registryName) ; 
for (String name : list) { 

System, out .printin (name) ; 

) 




java -cp build ListRegistry //locaihost 



7.3 Transport by reference 

Beim Aufruf entfernter Methoden werden lokale Objekte als 
Kopie in serialisierter Form übertragen. Das folgende Beispiel 
zeigt eine entfernte Methode, die als Rückgabewert eine entfern- 
te Referenz liefert, mit deren Hilfe eine entfernte Methode eines 
weiteren entfernten Objekts vom Client aufgerufen werden kann. 



Programm 7.2 



Test 
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Programm 73 



Ko n toException 



Remote Interface 
Konto 



Remote Interface 
KontoManager 



Kontolmpl 



Der RMI-Server soll Konten mit den Attributen Kontonummer 
(id), PIN und Saldo verwalten. Der Client kann ein neues Konto 
mit Angabe von Kontonummer und PIN anlegen oder ein bereits 
unter seiner Kontonummer eingerichtetes Konto öffnen. Für 
dieses Konto kann er dann einen Betrag einzahlen oder abheben 
sowie sich seinen Kontostand anzeigen lassen. 



Für dieses Beispiel nutzen wir eine eigene Exception-Klasse: 



public dass KontoException extends Exception { 
public KontoException () { } 

public KontoException (String msg) { 
super (msg) ; 

} 



import java.mi.*; 

public interface Konto extends Remote { 
int getSaldo() throws RemoteException; 

void add(int betrag) throws RemoteException, KontoException; 

} 



import java.rmi.*; 

public interface KontoManager extends Remote { 

Konto getKonto(int id, int pin) throws RemoteException, 
Kont oExcept ion ; 

} 



Die entfernte Methode getKonto gibt eine entfernte Referenz auf 
ein Konto-Objekt zurück. 



Wird versucht, das Konto zu überziehen, so wird eine Ausnahme 
vom Typ KontoException ausgelöst. 



import java.rmi.*; 
import java . rmi . Server . * ; 

public dass Kontolmpl extends UnicastRemoteObject implements Konto { 
private int id; 
private int pin; 
private int saldo; 

public Kontolmpl (int id, int pin) throws RemoteException { 
this.id = id; 
this.pin = pin; 

} 
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public int getSaldoO throws RemoteException { 
retum saldo; 

} 



public void add(int betrag) throws RemoteException, KontoException { 
if (saldo + betrag < 0) { 
throw new KontoException ( 

"Das Konto kann nicht ueber zogen werden."); 

} 

saldo += betrag; 



public int getPin() { 
retum pin; 



} 



Ko ntoManagerl mpl 



public dass KontoManagerlmpl extends UnicastRemoteObject 
implements KontoManager { 

private Hashtable<Integer, KontoIrrpl> hashtable; 

public KontoManager Irrpl ( ) throws RemoteException { 
hashtable = new Hashtablednteger, KontoImpl> ( ) ; 

} 



iirport java . rmi . * ; 
irrport java . rmi . Server . * ; 
iirport java.util.*; 



public Konto getKonto(int id, int pin) throws RemoteException, 
KontoException { 

Kontolrrpl konto = hashtable . get (id) ; 
if (konto = null) { 

konto = new Kontolmpl (id, pin) ; 
hashtable . put ( id, konto ) ; 

System. out . print ln ( "Konto " + id + " wurde eingerichtet."); 
retum konto; 

} 

eise { 

if ( konto. getPin() = pin) 
return konto; 
eise 

throw new KontoException ("PIN ist ungueltig. ") ; 




Die Konten werden in einer Hashtable unter der jeweiligen 
Kontonummer gespeichert. 

Ist bereits unter der angegebenen Kontonummer ein Konto vor- 
handen, so wird geprüft, ob die angegebene PIN gültig ist. Ist 
die PIN nicht korrekt, wird eine Ausnahme ausgelöst. Ist die 
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BankServer 



BankClient 



Kontonummer neu, so wird ein neues Konto eingerichtet. Bei 
fehlerfreier Verarbeitung wird in beiden Fällen die entfernte 
Referenz auf ein Konto-Objekt zurückgeliefert. 



irrport java.rmi.*; 
public dass BankServer { 

public static void min (String args [ ] ) throws Exception { 
Remote remote = new KontoManagerlrrpl ( ) ; 

Naming . rebind ( "bank " , remote ) ; 

System . out . print ln ( "BankServer gestartet 




Beim Aufruf des Client werden als Parameter u.a. Kontonummer 
und PIN mitgegeben. Das Programm ermöglicht die Ausführung 
verschiedener Aktionen: 

get Anzeige des Saldos 

+nnn Betrag nnn einzahlen 

-nnn Betrag nnn auszahlen 

q Beenden 



irrport java.rmi.*; 
irrport java.io.*; 

public dass BankClient { 

public static void min (String args [ ] ) throws Exception { 
if (args.length != 3) { 

System. err .printin ("java BankClient <host> <id> <pin>") ; 
System. exit (1) ; 

} 



String host = args[0]; 

int id = Integer. parseint (args [1] ) ; 

int pin = Integer. parseint (args [2] ) ; 

KontoManager manager = (KontoManager) Naming. lookup( 

"//" + host + "/bank"); 

Konto konto = manager. getKont o (id, pin); 

BufferedReader in = new Buf feredReader ( 
new InputStreamReader (System. in) ) ; 

String input; 

while (true) { 
try { 

System, out . print ln ( "Korrmando eingeben (get | <zahl>| q):"); 
input = in . readLine ( ) ; 
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if (input = null || input.lengthO = 0 || input . equals ( "q" ) ) 
break; 

if (input. equals ("get") ) { 

System. out. printin ("Aktueller Kontostand: " + 
konto . getSaldo ( ) ) ; 

} 

eise ( 

int betrag = Int eger. parseint (input) ; 
konto . add (betrag) ; 



catch (NumberFormatException e) { } 
catch (KontoException e) { 

System, out . printin (e . getMessage ( ) ) ; 

) 




Mit lookup erhält der Client Zugriff auf das entfernte KontoManager- 
Objekt. Hierfür ruft er die Methode getKonto auf und erhält als 
Rückgabewert eine entfernte Referenz auf ein KontoObjekt, für 
das er dann die entfernten Konto-Methoden aufruft. 



Registry und Server werden wie in Kapitel 7.1 aufgerufen. 



Aufruf des Client: 

java -cp build BankClient localhost 1 1234 

Kommando eingeben (get | <zahl>| q) : 

1000 

Kommando eingeben (get | <zahl> | q) : 
get 

Aktueller Kontostand: 1000 
Kommando eingeben (get | <zahl> | q) : 

-2000 

Das Konto kann nicht ueberzogen werden. 
Kommando eingeben (get | <zahl> | q) : 

q 



7.4 Mobile Agenten 

Ein (serialisierbares) Objekt kann auch dann vom Client zum 
Server transportiert werden, wenn der Server den Bytecode der 
zugehörigen Klasse noch nicht zur Verfügung hat. Der Code 
muss dann ebenfalls zur Laufzeit ad hoc übertragen werden. 

Wir nutzen hier diese Möglichkeit, um Methoden dieser Klasse 
auf dem Server lokal auszuführen. Derartige Nachrichten ent- 
sprechen von ihrem Wesen her einem mobilen Agenten , der im 



Test 
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Programm 7.4 



Agent 



ServerAgent 



Server Agentlmpl 



Server 



Auftrag eines Client bestimmte Aufgaben auf einem anderen 
Rechner erledigt und danach zurückkehrt. 



Wir entwickeln einen Server, der beliebige Aufgaben vom Client 
entgegennimmt, diese ausführt und die Ergebnisse zurückliefert. 
Das ist z. B. dann hilfreich, wenn der Server auf einer sehr 
schnellen Maschine läuft und komplexe mathematische Berech- 
nungen ausgeführt werden müssen. 

Eine Aufgabe kann durch ein beliebiges Objekt repräsentiert 
werden, dessen Klasse das Interface Agent implementiert: 



public interface Agent extends java.io.Serializable { 
void execute () ; 

} 



import java.mi.*; 

public interface ServerAgent extends Remote { 

Agent execute (Agent agent) throws RemoteException; 

} 



Die entfernte Methode execute des Remote Interface ServerAgent 
initiiert den Transport des Agent-Objekts und ruft die Agent- 
Methode execute auf: 



import java.rmi.*; 
import java.rmi. Server.*; 

public dass ServerAgent Impl extends UnicastRemoteObject 
implements ServerAgent { 

public ServerAgent Impl ( ) throws RemoteException { } 

public Agent execute (Agent agent) throws RemoteException { 
agent . execute ( ) ; 
retum agent; 




import java.rmi.*; 
public dass Server { 

public static void main (String args [ ] ) throws Exception { 
Remote remote = new ServerAgent Impl () ; 

Naming . rebind ( " agent " , remote ) ; 

System. out .print ln ( "Server gestartet ..."); 
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Die Klasse DemoAgent implementiert das Interface Agent. Die Me- 
thode execute berechnet die Summe der Zahlen von 1 bis zu einer 
vorgegebenen Zahl n. Diese Klasse soll später über das Netz zum 
Server transportiert werden. 



public dass DemoAgent implements Agent { 
private int n; 
private int sum; 

public DemoAgent (int n) { 
this.n = n; 

} 



public void execute () { 

for (int i = 1; i <= n; i++) { 
sum += i; 

} 

} 



public int getResultO { 
retum sum; 

} 



iirport java.rmi.*; 
public dass Client { 

public static void main (String args[]) throws Exception { 
String host = args[0]; 

ServerAgent remote = (ServerAgent) Naming.lookup ( 

"//" + host + "/agent"); 

Agent demo = new DemoAgent (100) ; 

DemoAgent result = (DemoAgent) remote. execute (demo) ; 
System. out .print ln (result . getResult ( ) ) ; 



} 



Zum Test werden für Client und Server verschiedene Verzeich- 
nisse eingerichtet. Die Klasse DemoAgent ist so für den Server lokal 
nicht erreichbar. 

Um den Bytecode von DemoAgent herunterladen zu können, nutzt 
der Server einen HTTP-Server. Hier kann ein beliebiger Webser- 
ver genutzt werden. Ein einfacher HTTP-Server, der auf Anfrage 
Bytecode liefert, ist im Online-Service zu diesem Programmbei- 
spiel vorhanden. 

Für den Start des Client ist der URL für den zu übertragenden 
Bytecode als Wert der Property 



DemoAgent 



Client 



java . rmi . Server . codebase 



250 



7 Entfernter Methodenaufruf mit RMI 



policy.txt 



Bild 7.4: 

Dynamisches Laden 
einer Klasse 



Test 



anzugeben. Diese Information wird zum Client übertragen, so- 
dass dieser dann die geeignete HTTP -Anfrage stellen kann. 

Der Server muss einen Security Manager nutzen, da das Laden 
von Bytecode im Allgemeinen eine unsichere Aktivität ist. 

Die Policy-Datei hat für unsere Zwecke den folgenden Inhalt: 



grant { 

permission java.net .SocketPemission "*:1024-", " connect , accept " ; 
permission java.net .SocketPemission "*:8080", "connect"; 

}; 



Unser HTTP-Server wird an die Portnummer 8080 gebunden 
werden, die somit bei der obigen Festlegung berücksichtigt ist. 

Bild 7.4 zeigt die Konfiguration. Insbesondere geht aus der Ab- 
bildung hervor, welche Klassen dem Client, welche dem Server 
lokal zur Verfügung stehen. 




Lokal verfügbare Klassen: 

Agent 

ServerAgent 

DemoAgent 

Client 



vom Typ DemoAgent Lokal verfügbare Klassen: 

Agent 

ServerAgent 
ServerAgent Impl 
Server 



Aufruf von Registry und Server (jeweils in einer Zeile ein- 
zugeben): 

Start /Dbuild rmiregistry 

Start java -Djava. Security. manager -Djava. Security. policy=policy.txt 
-cp build Server 

Aufruf des im Online-Service vorhandenen HTTP-Servers (im 
Verzeichnis . . /client/build befindet sich der Bytecode Demo- 
Agent, dass): 

Start java -cp build HTTPServer 8080 . ./dient /build 
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Aufruf des Client (in einer Zeile einzugeben): 

java -Djava.rmi. Server. codebase=http://localhost:8080/ -cp build 
Client localhost 



7.5 Callbacks 

In diesem Kapitel sehen wir, dass ein Client auch zeitweise selbst 
Dienste anbieten kann. Der Server ruft eine entfernte Methode 
des Client auf. 



Eine typische Anwendungssituation ist: Der Client will Ereignisse 
beobachten, die auf dem Server eintreten. Statt nun regelmäßig 
in bestimmten Abständen eine Anfrage an den Server zu stellen, 
ob das interessierende Ereignis eingetreten ist oder nicht 
(Polling), lässt sich der Client vom Server über das Eintreten des 
Ereignisses informieren (Callback). 

Damit dieser Callback-Mechanismus funktioniert, muss der 
Client sich beim Server registrieren (der Server speichert eine 
entfernte Referenz auf ein Remote-Objekt des Client). Dann kann 
der Server bei Eintreten des Ereignisses eine entfernte Methode 
des Client aufrufen. Bei dieser Lösung fällt im Vergleich zum 
Polling unnötige Rechenzeit und Netzlast weg. 



Zur Veranschaulichung dieses Mechanismus entwickeln wir eine 
Anwendung (Client und Server), mit der Textnachrichten, die ein 
so genannter Publisher veröffentlicht, an interessierte Abonnen- 
ten ( Subscriber ) gesendet werden können. Der Server hat die 
Aufgabe, eine an ihn gerichtete Nachricht sofort an alle Abon- 
nenten weiterzuleiten. Zu diesem Zweck muss er diese "kennen". 



Textnachrichten werden in ein Massage-Objekt verpackt, das zu- 
sätzlich den Zeitpunkt der Veröffentlichung enthält. 



public dass Message irnplements java.io.Serializable { 
private long timestanp; 
private String text; 

public void set Timestanp (long timestanp) { 
this. timestanp = timestanp; 

} 



public long getTimestampQ { 
retum timestanp; 



Polling oder 
Callback 



Programm 7.5 



Message 



252 



7 Entfernter Methodenaufruf mit RMI 



MessageListener 



MessageManager 



public void setText (String text) { 
this.text = text; 

} 



public String getText ( ) { 
retum text; 

} 



Das entfernte Objekt des Servers (vom Typ MessageManager) hat drei 
Methoden: 

• void setMessageListener (MessageListener listener) 

meldet einen Subscriber an. 

• void removeMsssageListener (MessageListener listener) 

meldet einen Subscriber ab. 

• void send (Message msg) 

sendet eine Nachricht. 



Das entfernte Objekt des Client (vom Typ MessageListener) hat die 
Methode: 

• void onMessage (Message msg) 

gibt die Nachricht aus. 



import java.mi.*; 

public interface MessageListener extends Remote { 
void onMessage (Message msg) throws RemoteException; 

} 

import java.mi.*; 

public interface MessageManager extends Remote { 
void setMessageListener (MessageListener listener) 
throws RemoteException; 

void removeMes sageLi stener (MessageListener listener) 
throws RemoteException; 

void send (Message msg) throws RemoteException; 



Bild 7.5 zeigt den Zusammenhang. 
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Bild 7.5: 

Callback- 

Mechanismus 




Wir implementieren zunächst den RMI-Server. Das vector-Objekt 
üsteners ist die Liste, die die entfernten Referenzen auf die 
MessageListener-Objekte der Abonnenten verwaltet. Die Methode 
send ruft für jede in der Liste gespeicherte Referenz die entfernte 
MessageListener-Methode onMessage auf. Wird hierbei (z.B. aufgrund 
des Abbruchs eines Subscribers) eine RemoteException ausgelöst, so 
wird die entsprechende Referenz aus der Liste entfernt. 

Ein Thread gibt alle 5 Sekunden die Anzahl der Abonnenten am 
Bildschirm aus. 



import java.rmi.*; MessageManager- 

irnport java.rmi. Server.*; T , 

import java.util.*; 

public dass MessageManager Impl extends UnicastRemoteObject 
implements MessageManager { 

private Vector<MessageListener> Üsteners; 

public MessageManager Impl ( ) throws RemoteException { 

Üsteners = new Vector<MessageListener> ( ) ; 
new ControlThread ( ) . Start ( ) ; 

} 



public void setMessageListener (MessageListener Üstener) 
throws RemoteException { 



Üsteners . add (üstener) ; 
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MessageServer 



Publisher 



public void removeMessageListener (MessageListener listener) 
throws Remot eExcept ion { 

listeners . remove (listener) ; 



public synchronized void send (Message msg) throws RemoteException { 
for (int i = listeners. size () - 1; i >= 0; i — ) { 

MessageListener listener = listeners . get (i) ; 
try { 

listener . onMessage (msg) ; 

} 

catch (RemoteException e) { 
listeners. remove (listener) ; 

} 




private dass ControlThread extends Thread { 
public void run() { 
while (true) { 
try { 

Thread. sleep (5000) ; 

} 

catch (InterruptedException e) { } 



Sy stem . out . print ln ( "Anzahl Subscriber s : 



+ listeners . size ( ) ) ; 



irrport java.mi.*; 

public dass Mas sageServer { 

public static void main (String args [ ] ) throws Exception { 
Remote remote = new MessageManagerlmpl () ; 

Naming . rebind ( "mes sage " , remote ) ; 

System . out . printin ( "MessageServer gestartet ..."); 




Nun implementieren wir Publisher und Subscriber. 



irrport java.mi.*; 
public dass Publisher { 

public static void main (String args [ ] ) throws Exception { 
if (args.length != 2) { 

System. err .printin ("java Publisher <host> <text>"); 
System. exit (1) ; 



7.5 Callbacks 
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String host = args[0]; 

String text = args[l]; 

MessageManager manager = (MessageManager) Naming.lookup( 
"//" + host + "/message") ; 

Message msg = new Message () ; 
msg.setTimestamp(System.currentTimeMillis () ) ; 
msg. setText (text) ; 
manager . send (msg) ; 



} 



import java.rmi.*; 
import java.rmi. Server.*; 
import java.util.*; 
import java.text.*; 

public dass MessageListenerlmpl extends UnicastRemoteObject 
implements MessageListener { 

private SimpleDateFormat formatter; 

public MessageListenerlmpl ( ) throws RemoteException { 

formatter = new SimpleDateFormat ( "E, MMM d, yyyy HH:mm:ss z") ; 

} 



public void onMessage (Message msg) throws RemoteException { 

String timestamp = formatter. format (new Date (msg. getTimestamp ())) ; 
System.out.println (timestamp) ; 

System . out . printin (msg . getText ( ) ) ; 



} 



import java.rmi.*; 
public dass Subscriber { 

public static void main (String args[]) throws Exception { 
if (args.length != 2) { 

System. err .printin ("java Subscriber <host> <millis>") ; 
System. exit(l) ; 

} 



String host = args[0]; 

int millis = Integer .parseint (args [1] ) ; 

MessageManager manager = (MessageManager) Naming.lookupt 
"//" + host + "/message") ; 

Mes sageLi stener listener = new MessageListenerlmpl ( ) ; 
manager . setMessageListener (listener) ; 

try { 

Thread. sleep (millis) ; 



MessageL istenerl mpl 



Subscriber 
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Test 



CORBA 



IIOP 



catch (InterruptedException e) { } 

manager.removeMessageListener (listener) ; 
System. exit (0) ; 




Aufruf von Registry und Server: 

Start /Dbuild miregistry 

Start java -cp build MessageServer 

Aufruf zweier Abonnenten: 

Start java -cp build Subscriber localhost 30000 
Start java -cp build Subscriber localhost 30000 

Aufruf eines Publishers: 

java -cp build Publisher localhost "Das ist ein Test" 



7.6 Exkurs: RMI mit IIOP 

CORBA ( Common Object Request Arcbitecture), eine Spezifikati- 
on der Object Management Group ( OMG ), stellt eine Kommuni- 
kations- und Dienstinfrastruktur für verteilte objektorientierte An- 
wendungen bereit. Die Methodenaufrufe sind sprach unabhän- 
gig, d.h. Client und Server können mit unterschiedlichen Pro- 
grammiersprachen implementiert werden. Schnittstellen werden 
mit der speziellen Beschreibungssprache IDL ( Interface Definiti- 
on Language) unabhängig von der Implementierungssprache 
definiert. Im Vergleich zu RMI ist CORBA jedoch komplizierter 
und aufwändiger in der Umsetzung. 



CORBA nutzt clas Kommunikationsprotokoll IIOP ( Internet Inter- 
ORB Protocol) auf der Basis von TCP/IP. 

Neben dem Protokoll JRMP für eine reine Java-Umgebung (siehe 
Kapitel 7.1) unterstützt RMI auch IIOP (Java RMI over IIOP) und 
hat damit Zugang zu anderen CORBA-Anwendungen. Enterprise 
JavaBeans ( EJB ) der Plattform Java EE kommunizieren in der 
Regel über RMI/IIOP. 



7.6 Exkurs: RMI mit IIOP 
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Im Folgenden wird gezeigt, wie eine einfache verteilte Anwen- 
dung auf der Basis von RMI mit IIOP implementiert werden 
kann. Analog zur RMI-Registry wird hier ein IlOP-fähiger Na- 
mensdienst, der vom Object Request Broker Daemon (orbd) an- 
geboten wird, eingesetzt. 



iirport java.rmi. Remote; 
iirport java.rmi. RemoteException; 

public interface LagerService extends Remote { 
Lager getLager (String id) throws RemoteException; 

} 



Zu einer Artikelnummer id liefert die Methode getLager das zuge- 
hörige Lager-Objekt. Die Klasse Lager muss das Interface java. 
io . seriaiizabie implementieren. 



import java. util. Date; 
iirport java. io. Seriaiizabie; 

public dass Lager implements Seriaiizabie { 
private String id; 
private int bestand; 
private Date datum; 

public Lager (String id, int bestand, Date datum) { 
this.id = id; 
this. bestand = bestand; 
this. datum = datum; 

} 



public String getldO { 
return id; 

} 



public void setld (String id) ( 
this.id = id; 

} 



public int getBestandO { 
return bestand; 

} 



public void setBestand(int bestand) { 
this. bestand = bestand; 

} 



public Date getDatumQ { 
return datum; 



Programm 7.6 



Interface 

LagerService 



Die Klasse Lager 
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public void setDatum (Date datum) { 
this. datum = datum; 

} 



Implementierung 

LagerServicelmpl 



import java.rmi.RemoteException; 
import javax.rmi.PortableRemoteObject; 
import java.util.Hashtable; 
import java.util.Date; 



public dass LagerServicelmpl extends PortableRemoteObject 
implements LagerService { 



private Hashtable<String, Lager> table; 



public LagerServicelmpl () throws RemoteException ( 

table = new Hashtable<String, Lager> ( ) ; 

Date datum = new Date () ; 

Lager[] list = new Lagert] { 
new Lager ("4711", 100, datum), 
new Lager ("4712", 80, datum), 
new Lager ("4713", 55, datum) 

}; 

for (int i = 0; i < list . length; i++) { 
table. put (list [i] .getldO , list [i] ) ; 

} 



public Lager getLager (String id) throws RemoteException { 
retum table. get (id) ; 

} 



Da Client und Server über IIOP kommunizieren sollen, muss 
die Klasse von javax.rmi.PortableRemoteObject abgeleitet werden. 



Der Server 
LagerServer 



import javax . naming . InitialContext ; 
import javax. naming. Context; 

public dass LagerServer { 

public static void main (String args [ ] ) throws Exception { 
LagerService Service = new Lager Service Impl () ; 

// Referenz im Naming Service mit JNDI veröffentlichen 
Context ctx = new InitialContext () ; 
ctx . rebind ( " LagerService " , Service ) ; 



System . out . print ln ( "LagerServer gestartet ..."); 



7.6 Exkurs: RMI mit IIOP 
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Das Programm erzeugt ein Service-Objekt und meldet dieses 
beim Namensdienst an. Auf den Namensdienst wird mit Hilfe des 
API JNDI {Java Naming and Directory Interface) zugegriffen. 
Hierzu werden das Interface Context und die Klasse initiaicontext, 
beide aus dem Paket javax. naming, genutzt, der Service wird unter 
dem Namen "Lagerservice" eingetragen. Konkrete Angaben zum 
gewählten Namensdienst werden beim Aufruf des Programms 
über Properties eingestellt. 



import javax. naming. Initiaicontext; 

import javax. naming. Context; 

import javax. rmi.PortableRemoteObject; 

public dass LagerClient < 

public static void main (String args[]) throws Exception { 
if (args.length != 1) { 

System. err .printin ("java LagerClient <id>") ; 

System. exit(l) ; 

} 



String id = args[0]; 

// Referenz vom Naming Service mit JNDI erfragen 
Context ctx = new Initiaicontext ( ) ; 

Object objref = ctx.lookupC'LagerService") ; 

// Referenz casten 

LagerService Service = (LagerService) PortableRemoteObject.narrow( 
objref, LagerService. dass) ; 

Lager lager = Service. getLager (id) ; 

if (lager = null) { 

System. out .printin ("Lager nicht vorhanden"); 

} 

eise { 

System. out. println(lager.getld() ) ; 

System . out . printin ( lager . getBestand ( ) ) ; 

System . out . printin ( lager . getDatum ( ) ) ; 



} 



Der Client kontaktiert den Namensdienst und erfragt mit 
lookup das als "Lagerservice" registrierte Service-Objekt. Die gelie- 
ferte Referenz muss mit narrow auf den entsprechenden Interface- 
Typ "gecastet" werden. 



Nach Compilierung der Sourcen mit javac müssen mit rmic ein 
Stub und eine so genannte Tie-Klasse generiert werden: 



Der Client 
LagerClient 



Compilierung 
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Namensdienst 

starten 



Start des Servers 



Start des Client 



rmic -classpath build -d build -iiop LagerServicelmpl 

Mit Hilfe der zusätzlichen Option -idi können nach Bedarf auch 
die IDL-Beschreibungen zum Interface erzeugt werden. 



Der Namensdienst wird wie folgt auf Port 50000 gestartet: 
Start orbd -ORBInitialPort 50000 



Start java -cp build LagerServer 

Die im bui-ld-Ve rzeichnis abgelegte Datei jndi. properties enthält 
den Namen der JNDI-Treiberklasse für den Namensdienst sowie 
dessen URL: 

java . naming . factory . initial=com. sun . jndi . cosnaming . CNCtxFactory 
java . naming . provider . url=iiop : / /localhost : 50000 



java -cp build LagerClient 4711 

Hier werden auch die Angaben in der Datei jndi .properties ge- 
nutzt. Zur Ausführung werden die folgenden Bytecode-Dateien 
benötigt: Lager, dass, LagerService . dass, LagerClient . dass und 

_LagerService_Stub . dass. 



Namensdienst, Server und Client können jeweils auf verschiede- 
nen Rechnern im Netz laufen. 



7.7 Aufgaben 

1. Programmieren Sie einen RMI-Dienst, dessen entfernte 
Methode 

String getDaytimeO 

die aktuelle Systemzeit des Servers liefert. 

2. Aus einer Bücher-Datenbank sollen zu einer vorgegebenen 
Buchnummer Angaben zum Buch (Autor und Titel) über 
SQL abgefragt werden. Entwickeln Sie einen RMI-Dienst 
(inkl. Server) mit der Methode 

Buch getBuch (String id) 

und einen Client, der diese entfernte Methode aufruft. 

Die Klasse Buch soll die Angaben zum Buch als Attribute mit 
den entsprechenden set- und get-Methoden enthalten (vgl. 
auch Aufgabe 5 in Kapitel 4). 



7.7 Aufgaben 
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3. Erstellen Sie für den RMI-Server aus Kapitel 7.4 einen neuen 
Agenten, der zu einer vorgegebenen Zahl n die Fakultät n! 
ermittelt. Zur Berechnung kann die Klasse java.math. 
Biginteger genutzt werden. 

4. Programmieren Sie ein Applet, das als Subscriber im Rah- 
men von Programm 7.5 Nachrichten in einer Textfläche 
( jiextArea) anzeigt. Hierzu muss MessageListenerimpi aus Pro- 
gramm 7.5 so angepasst werden, dass die Ausgabe in der 
Textfläche erscheint. 

5. Entwickeln Sie nach der Vorlage in Kapitel 4.5 (Programm 
4.3) ein auf RMI basierendes Chat-Programm: RMI-Server, 
RMI-Client (als eigenständige Applikation und als Applet). 
Der Client soll die gleiche Anwendungsfunktionalität und 
Benutzungsoberfläche haben wie das in Kapitel 4.5 entwi- 
ckelte Programm. Nutzen Sie den Callback-Mechanismus. 

6. Erstellen Sie einen universellen RMI-Server (Multiserver), der 
mehrere Dienste gleichzeitig anbieten kann. Zur Laufzeit sol- 
len bestehende Dienste beendet und neue Dienste hinzuge- 
fügt werden können. Ebenso soll der Server kontrolliert be- 
endet werden können. 

Der Server soll selbst den Dienst MuitiserverManager mit den 
folgenden Methoden anbieten: 

void shutdown ( ) 
void reconfigure () 

Die neu hinzuzufügenden Dienste sind in einer Textdatei in 
folgender Form (Beispiel) gespeichert: 

echo Echolrnpl 

daytime Daytimelrrpl 

Jede Zeile entspricht einem Dienst. Sie enthält den Dienst- 
namen und den Namen der Klasse, die den Dienst erbringt. 
Diese Datei ist bei der Rekonfiguration einzulesen. 

Für jeden Eintrag soll mittels Reflection (Nutzung der ciass- 
Methoden forName und newinstance) ein neues entferntes Ob- 
jekt erzeugt und bei der Registry angemeldet werden. 

Des Weiteren ist ein Client MuitiServerManagerCiient zu erstel- 
len, der den Aufruf der Methoden shutdown und reconfigure 
ermöglicht. 




8 Nachrichtendienste mit JMS 



Die Kommunikation zwischen Client und Server in den vorange- 
gangenen Kapiteln ist dadurch gekennzeichnet, dass die Teil- 
nehmer direkt und zeitgleich miteinander in Verbindung treten. 
In der Regel ist der Client solange blockiert, bis der Server die 
Verarbeitung abgeschlossen und die Antwort zurückgesendet hat 
(synch ron e Koni m u n ikation ) . 

Die Kommunikation auf der Basis von nachrichtenorientierter 
Middleware ( Message Oriented Middleware, MOM) macht sich 
von dieser engen Kopplung frei. Der Austausch von Nachrichten 
erfolgt asynchron mit Hilfe eines Vermittlers ( Message Broker, 
MOM-Server), der eine Warteschlange verwaltet. Die Nachricht 
des Senders wird vom Vermittler in die Warteschlange des Emp- 
fängers gelegt. Der Empfänger kann diese Nachricht zu einem 
späteren Zeitpunkt aus der Warteschlange holen. Sender und 
Empfänger agieren unabhängig voneinander und sind also über 
den Vermittler nur lose gekoppelt. 




MOM-Server 



Vorteile dieser asynchronen Kommunikation sind: 

• Sender und Empfänger arbeiten unabhängig voneinander. 
Auch bei Ausfall eines Teils (Sender, Empfänger oder Vermitt- 
ler) kann die Nachricht noch nachträglich zugestellt werden. 
Die beteiligten Komponenten können getrennt voneinander 
wieder gestartet werden. Daraus ergibt sich eine hohe Fehler- 
toleranz. 

• Eine Nachricht kann dank des Vermittlers an mehrere Emp- 
fänger gesendet werden, ohne dass jeweils eine explizite 
Verbindung vom Client zu jedem Empfänger aufgebaut wer- 
den muss. 

• Mehrere gesendete Nachrichten können gebündelt werden 
und zur Steigerung der Effizienz erst zu einem späteren Zeit- 
punkt in einem Rutsch abgeholt und verarbeitet werden. 

• Durch Verwendung nachrichtenorientierter Middleware ist die 
Kommunikation unabhängig von Programmiersprache und 
Plattform. 



MOM 



Bild 8.1 

Nachrichten- 

austausch 



Vorteile 
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Komponenten einer 
JMS-Anwendung 



• Die weitgehende Unabhängigkeit von Sender und Empfänger 
fördert den Einsatz dieser Technologie im Bereich der An- 
wendungsintegration. 



8.1 Java Message Service 

Java Message Service (JMS) wurde 1998 von Sun Microsystems 
veröffentlicht und ist inzwischen integraler Bestandteil der Java 
Enterprise Edition (Java EE). JMS ist ein API, das Syntax und 
Semantik für den Zugriff auf nachrichtenorientierte Middleware 
definiert. Verschiedene Hersteller bieten Implementierungen an, 
die dieser Spezifikation genügen. Jeder zu Java EE konforme 
Application Server muss über eine MOM-Implementierung verfü- 
gen. 



Wir nutzen in diesem Kapitel 

• JMS 1.1 

JAR-Datei und Dokumentation können über die Webseite 
http : // java . sun . com/products/ jms/ 
heruntergeladen werden. 

• JBoss Application Server 4.0.5 

JBoss ist frei verfügbar und kann über die Webseite 

http : //www. jboss . org 

heruntergeladen werden. 



• Alternativ kann auch die Open-Source-JMS-Implementierung 
Apache ActiveMQ eingesetzt werden. Sie kann über die Web- 
seite 

http : //www . activemq . org 

heruntergeladen werden. Näheres hierzu enthält cler Online- 
Service. 



Eine JMS-Anwendung besteht aus einem JMS-Provider und meh- 
reren JMS-Clients. 

• JMS-Provider 

Der JMS-Provider ist der MOM-Server, in unserem Fall also 
der JBoss Application Server. 

• JMS -Clients 

JMS-Clients sind die Java-Programme, die Nachrichten senden 
(Message Producer) bzw. empfangen (Message Consumer) . 



8.1 Java Message Service 
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• Messages 

Messages (Nachrichten) haben ein festgelegtes Format und 
werden von JMS-Clients erzeugt, versandt und empfangen. 

• Administrierte Objekte 

Administrierte Objekte werden vom JMS-Provider bereitge- 
stellt und in einem Namensdienst veröffentlicht (siehe auch 
Kapitel 7.1). Diese Objekte werden von JMS-Clients über 
JNDI (Java Naming and Directory Interface) angefordert (sie- 
he auch Kapitel 7.6), um Nachrichten senden oder empfan- 
gen zu können. Die Verbindungsfabrik (ConnectionFactory) 
und Nachrichtenziele (Destinations) sind administrierte Ob- 
jekte. 



Bild 8.2 zeigt die allgemeinen Schnittstellen des JMS-API. Je nach 
verwendetem Nachrichtenmodell (Point-to-Point, Publish- 
Subscribe) werden spezialisierte Schnittstellen eingesetzt. Die 
beiden Nachrichtenmodelle werden in späteren Abschnitten 
behandelt. 




Bild 82: 

Wichtige JMS- 
Schnittstellen 



Die Interfaces und Klassen des JMS-API gehören alle zum Paket Paket javaxjms 

javax. jms. 

Im Folgenden werden die in Bild 8.2 aufgeführten Interfaces 
kurz beschrieben. 
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ConnectionFactory 

Die Verbindungsfabrik dient dazu, Verbindungen zu einem JMS- 
Provider aufzubauen. Sie kann vom Administrator konfiguriert 
werden (administriertes Objekt) und wird in der Regel über ei- 
nen Namensdienst zur Verfügung gestellt. 



Connection 

Eine Verbindung wird von einer Verbindungsfabrik erzeugt und 
stellt einen Kommunikationskanal zum JMS-Provider dar. 



Session 

Eine Sitzung wird von einer geöffneten Verbindung erstellt und 
repräsentiert einen Kontext, in dem Nachrichten, Sender oder 
Empfänger erzeugt werden. 



Message 

Eine Nachricht besteht aus einem Kopf (Header), Eigenschaften 
(Properties) und einem Rumpf (Body). 

Der Kopf enthält verschiedene Felder, die zur Identifizierung 
und Verwaltung genutzt werden und zum Teil vom JMS-Provider 
automatisch gesetzt werden. Einige Header werden in den Bei- 
spielen dieses Kapitels verwendet. 

Anwendungsbezogen können weitere Eigenschaften hinterlegt 
werden. Hierzu stehen die folgenden Methoden zur Verfügung: 

void setJöo^rcperty (String name, xxx value) throws JMSException 
xxx getAx^rqperty (String name) throws JMSException 

Hierbei Steht xxx für boolean, byte, short, int, long, float, double oder 
String. 

Der Rumpf speichert die Nutzdaten. Es existieren unterschiedli- 
che Nachrichtentypen in Form von spezialisierten Interfaces: 

BytesMsssage, MapMassage, ObjectMsssage, StreamMessage und TextMessage. 
Zwei dieser Typen werden in den Beispielen dieses Kapitels 
behandelt. 



MessageProducer 

Der MessageProducer hat die Aufgabe, Nachrichten an ein Ziel 
zu versenden. 



MessageConsumer 

Der MessageConsumer empfängt Nachrichten vom JMS-Provider 




8.2 Das Point-to-Point-Modell 
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Destination 

Ein Nachrichtenziel (Destination-Objekt) repräsentiert eine Warte- 
schlange des JMS-Providers. Dieses kann vom Administrator 
eingerichtet (administriertes Objekt) und über einen Namens- 
dienst bereitgestellt werden. 



8.2 Das Point-to-Point-Modell 

Beim Point-to-Point-Modell (P2P) wird eine vom Sender erzeugte 
Nachricht über eine Queue an genau einen Empfänger übermit- 
telt (siehe Bild 8.1). 

Sobald der Empfänger den Erhalt der Nachricht bestätigt hat, gilt 
sie als verbraucht und kann nicht erneut geholt werden. MOM- 
Server bieten das Konzept der persistenten Warteschlange. Nach- 
richten werden bis zu ihrer Auslieferung dauerhaft in einer Da- 
tenbank gespeichert, sodass sie ihren Empfänger auf jeden Fall 
erreichen, wenn er wieder aktiv ist. 



In den Programmbeispielen dieses Abschnitts werden einfache 
Textnachrichten gesendet und empfangen. 

Zunächst wird die Warteschlange für JBoss konfiguriert. 

Die XML-Datei my Queue 1 -Service. xml enthält die erforderlichen Queue bereitstellen 
Angaben. Der Name der Queue ist myQueuel. Zugriff haben alle 
Benutzer mit der Rolle guest. 



Inhalt von myQueuel -Service. xml: 

<?xml version="1.0" encoding= n UTF-8"?> 

<server> 

<mbean code="org . jboss . mq. Server . jmx . Queue" 

name=" jboss . mq . destinat ion : service=Queue , name=myQueuel " > 
<depends opt ional-att ribute-name= "Destinat ionManager" > 
jboss .mq: service=Destinationiyianager 
</depends> 

<depends opt ional-att ribute-name= " SecurityManager" > 
jboss .mq: service=Securityiyianager 
</depends> 

<attribute name="SecurityConf"> 

<security> 

<role name=" guest" read="true" write="true"/> 
</security> 

</attribute> 

</mbean> 

</ server> 
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Diese Datei muss in das Verzeichnis 
< JBoss-Hcme>\server\def ault\deploy\ jms 
kopiert werden bevor oder nachdem der Server mit 

< JBoss-Hane>\bin\run .bat 

gestartet wurde. 

Meldung des JBoss Application Servers: 

INFO [myQueuel] Bound to JNDI name: queue/myQueuel 


Queue überwachen 


Die Queue kann mittels der JMX-Konsole überwacht werden. 
Hierzu ist die folgende Seite im Browser aufzurufen: 

http : //localhost : 8080 / jmx-console/ 

Unter jboss .mq.destination findet man den entsprechenden Ein- 
trag 

name=myQueuel , service=Queue 

Diverse Attribute und Operationen stehen zur Verfügung. 

Zunächst werden die in den Programmbeispielen benutzten 
Typen und Methoden vorgestellt. 


JMSException 


Die meisten Methoden des JMS-API lösen bei Fehlern eine Aus- 
nahme vom Typ JMSException (direkte Subklasse von Exception) 
aus. 


Queue 


Queue ist Subinterface von Destination und repräsentiert eine War- 
teschlange für das P2P-Modell. 


QueueConnection- 

Factory 


Das Interface QueueconnectionFactory ist ein Subinterface von 
ConnectionFactory. 

QueueConnection createQueueConnection (String user, String password) 
throws JMSException 

erzeugt eine Verbindung zu einer Queue. 


Connection 


void Start ( ) throws JMSException 

startet die Auslieferung eingegangener Nachrichten. 

void close () throws JMSException 

schließt die Verbindung. 


QueueConnection 


QueueConnection ist Subinterface von Connection und repräsentiert 
eine Verbindung zu einer Queue im P2P-Modell. 



8.2 Das Point-to-Point-Modell 



269 



QueueSession createQueueSession ( 

boolean transacted, int acknowledgeMode) throws JMSException 

erzeugt eine Session, transacted gibt an, ob das Senden bzw. 
Empfangen von Nachrichten innerhalb einer Transaktion stattfin- 
den soll. Im Beispiel wird keine Transaktionskontrolle genutzt. 
acknowledgeMode legt fest, wer für die Empfangsbestätigung zu- 
ständig ist. Im Beispiel wird Session. AUTO_Aa<NCffl£DGE (automati- 
sche Bestätigung durch die Session) genutzt. 



TextMessage createTextMsssage ( ) throws JMSException 

erzeugt eine Textnachricht. 

void close () throws JMSException 

schließt die Sitzung. 



QueueSession ist Subinterface von Session. 

QueueSender createSender (Queue queue) throws JMSException 
erzeugt einen Sender für queue. 

QueueReceiver createReceiver (Queue queue) throws JMSException 
erzeugt einen Empfänger für queue. 



void setTinreToLive ( long timeToLive) throws JMSException 

setzt die Gültigkeitsdauer für Nachrichten in Millisekunden 
(0 steht für unbegrenzt). 

void close () throws JMSException 

beendet den Message Producer. 



QueueSender ist Subinterface von MessageProducer. 

void send (Message message) throws JMSException 
sendet die Nachricht message. 



QueueReceiver ist Subinterface von Mes sageConsumer. 



Message receive() throws JMSException 

wartet auf das Eintreffen einer Nachricht und kehrt dann zurück. 

Message receive(long timeout) throws JMSException 

wartet maximal timeout Millisekunden auf das Eintreffen einer 
Nachricht und kehrt dann zurück. 

void setMsssageT.i stener (MessageListener listener) throws JMSException 
registriert ein Objekt vom Typ MessageListener, um asynchron auf 
eine Nachricht zu warten. 

void close () throws JMSException 

beendet den Message Consumer. 



Session 



QueueSession 



MessageProducer 



QueueSender 



QueueReceiver 



MessageConsumer 
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MessageListener 


Dieses Interface definiert die Methode 

void onMessage (Message message) 


TextMessage 


TextMsssage ist SubinterfäCe von Message, 
void setText (String string) throws JMSException 

setzt den Inhalt der Textnachricht. 

String getTextQ throws JMSException 

liefert den Inhalt der Textnachricht. 


Programm 8.1 


Es folgen die Programmbeispiele Producer, Consumerl und Consumer2. 


Producer 


import javax . jms . *; 
import javax . naming . * ; 

public dass Producer { 

private static final String DESTINATION = "queue/myQueuel"; 
private static final String USER = "guest"; 
private static final String PASSWORD = "guest"; 

private QueueConnection connection; 
private QueueSession session; 
private QueueSender sender; 
private String text; 
private long expiration; 

public Producer (String text, long expiration) 
throws NamingException, JMSException { 

this.text = text; 

this. expiration = expiration; 

// JNDI-Kontext erzeugen 

Context ctx = new InitialContext ( ) ; 

// ConnectionFactory über Namensdienst auslesen 
QueueConnectionFactory factory = 

( QueueConnect ionFact ory ) ctx . lookup ( "ConnectionFactory" ) ; 

// Zieladresse über Namensdienst auslesen 
Queue queue = (Queue) ctx . lookup (DESTINATION) ; 

// Verbindung aufbauen 

connection = factory . createQueueConnection (USER, PASSWORD); 
// Session erzeugen 

session = connection. createQueueSession ( 
false, Session. AUTO_ACKNOWLEDGE) ; 

// Sender erzeugen 

sender = session. createSender (queue) ; 
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// Nachricht erzeugen und senden 
public void sendMessage ( ) throws JMSException { 
TextMessage message = Session. createTextMessageO ; 
message . setText (text) ; 
sender . setTirreToLive (expiration) ; 
sender . send (message) ; 



// Ressourcen freigeben 
public void close ( ) throws JMSException { 
sender . close ( ) ; 

Session. close () ; 

Connection. close () ; 



public static void main (String [] args) throws Exception { 
String text = args[0]; 
long expiration = 

(args.length = 2) ? Long. parseLong (args [1] ) : 0; 
Producer producer = new Producer (text, expiration); 
producer . sendMessage ( ) ; 
producer . close ( ) ; 



} 



Im folgenden Programm wartet der Empfänger aktiv auf das 
Eintreffen von Nachrichten (Pull-Prinzip). Nach timeout Milli- 
sekunden Wartezeit wird das Programm beendet. 



irnport javax . jms . * ; 
irnport javax . naming . * ; 

public dass Consumerl { 

private static final String DESTINATION = "queue/myQueuel"; 
private static final String USER = "guest"; 
private static final String PASSWORD = "guest"; 

private QueueConnection connection; 
private QueueSession session; 
private QueueReceiver receiver; 
private long timeout; 

public Consumerl (long timeout) throws NamingExcept ion , 
JMSException { 

this. timeout = timeout; 

// JNDI-Kontext erzeugen 

Context ctx = new InitialContext ( ) ; 

// ConnectionFactory über Namensdienst aus lesen 
QueueConnect ionFact ory factory = 

( QueueConnect ionFact ory ) ctx . lookup ( "ConnectionFactory" ) ; 
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// Zieladresse über Namensdienst auslesen 
Queue queue = (Queue) ctx.lookup (DESTINATION) ; 

// Verbindung aufbauen 

Connection = factory . createQueueConnection (USER, PASSWORD) ; 
// Session erzeugen 

session = connection. createQueueSession ( 
false, Session .AUTO_ACKNOWLEDGE) ; 

// Empfänger erzeugen 

receiver = session. createReceiver (queue) ; 

// Empfang von Nachrichten starten 
connection. Start () ; 



// Aktives Warten auf Nachrichten (Pull-Prinzip) 
public void receiveMessage () throws JMSException ( 
Message message; 

while ((message = receiver. receive (timeout) ) != null) ( 
if (message instanceof TextMessage) < 

TextMessage textMessage = (TextMessage) message; 
System. out. printin (textMessage.getText () ) ; 




// Ressourcen freigeben 
public void closeO throws JMSException ( 
receiver . close () ; 
session. closeO ; 
connection . close ( ) ; 



public static void main (String [ ] args) throws Exception { 
long timeout = Long.parseLong(args [0] ) ; 

Consumerl consumer = new Consumerl (timeout) ; 
consumer . receiveMessage ( ) ; 
consumer . close (); 




Im Programm Consumer2 wird der Empfänger vom MOM-Server 
durch die Callback-Methode onMessage über das Eintreffen einer 
Nachricht informiert (Push -Prinzip). Das Programm wird nach 
timeout Millisekunden beendet. 
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irnport javax . jms . * ; 
irrport javax . naming . * ; 

public dass Consumer2 inplements MessageListener { 

private static final String DESTINATION = "queue/myQueuel"; 

private static final String USER = "guest"; 

private static final String PASSWORD = "guest"; 

private QueueConnection connection; 

private QueueSession session; 

private QueueReceiver receiver; 

public Consumer2 ( ) throws NamingException, JMSExcept ion { 

// JNDI-Kontext erzeugen 

Context ctx = new InitialContext ( ) ; 

// ConnectionFactory über Narnensdienst aus lesen 
QueueConnect ionFactory factory = 

( QueueConnect ionFact ory ) ctx . lookup ( "ConnectionFactory" ) ; 

// Zieladresse über Narnensdienst auslesen 
Queue queue = (Queue) ctx. lookup (DESTINATION) ; 

// Verbindung aufbauen 

connection = factory. createQueueConnect ion (USER, PASSWORD); 
// Session erzeugen 

session = connection . createQueueSession ( 
false, Session . AUTO_ACKNOWLEDGE ) ; 

// Enpfänger erzeugen 

receiver = session. createReceiver (queue) ; 

// MessageListener setzen 
receiver . setMessageListener (this) ; 

// Empfang von Nachrichten starten 
connection . Start ( ) ; 



// Nachrichten werden im Push-Verfahren empfangen 
public void onMessage (Message message) { 
try { 

if (message instanceof TextMessage) { 

TextMessage textMtessage = (TextMtessage) message; 
System, out . print ln (textMessage . getText ( ) ) ; 



catch (JMSException e) { 
System, err .printin (e) ; 



Consumer2 
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jndi. properties 



Test 



// Ressourcen freigeben 
public void closed throws JMSException ( 
receiver . close ( ) ; 

Session . close ( ) ; 

Connection . close ( ) ; 



public static void main (String [ ] args) throws Exception ( 
long timeout = Long.parseLong(args [0] ) ; 

Consumer2 consumer = new Consumer2() ; 

Thread. sleep (timeout) ; 
consumer . close ( ) ; 




Die Verbindungsdaten für den Zugriff auf den Namensdienst 
über JNDI sind in der Datei jndi. properties ausgelagert. 



java . naming . f actory . initial=org . jnp . interf aces . NamingContextFactory 
java. naming. provider ,url=jnp: //localhost : 1099 
java . naming . f actory . url . pkgs=org . jnp . interf aces 



Zur Compilierung wird die JAR-Datei jms.jar, zur Ausführung der 
Programme die JAR-Datei jbossall-client.jar aus der JBoss- 
Installation verwendet, jndi properties muss in das Verzeichnis 
build kopiert werden. 

Die Umgebungsvariablen jms_path und jbossclient_path müssen 
gesetzt werden: 

set JMS_PATH=Verzeichnis\ jms.jar 

set JBOSSCLIENT_PATH=Verzeichnis\client\ jbossall-client . jar 



javac -sourcepath src -cp %JMS_PATH% -d build src/* . java 
java -cp build; %JBOSSCLIENT_PATH% Producer Hallo 
java -cp build; %JBOSSCLIENT_PATH% Consumerl 5000 

oder 

java -cp build; %JBOSSCLIENT_PATH% Consumer2 30000 
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Programm 8.2 ermöglicht es, den Inhalt einer Warteschlange Programm 8.2 
abzufragen, ohne die Nachrichten zu löschen. 



Hierzu gibt es das Interface QueueBrowser mit den folgenden Me- QueueBrowser 
thoden: 

java.util. Enumeration getEnumeration ( ) throws JMSException 

liefert ein Enumeration-Objekt zum sequentiellen Durchlaufen der 

in der Warteschlange enthaltenen Nachrichten. 

void close () throws JMSException 

schließt den Browser. 



Mit der QueueSession-Methode 

QueueBrowser createBrowser (Queue queue) throws JMSException 

wird ein Browser für die Warteschlange queue erzeugt. 



Header einer Nachricht können mit get- und sef-Methoden des Nachrichtenkopf 
Interfaces Message abgefragt bzw. gesetzt werden. Programm 8.2 (Header) 
verwendet die folgenden automatisch gesetzten Header: 



JMSMessagelD 

Eindeutiger Bezeichner zur Identifikation einer Nachricht (Typ 

String). 



JMSPriority 

Wert zwischen 0 (niedrig) und 9 (hoch), der die Priorität der 
Auslieferung einer Nachricht festlegt (Typ int). 



JMSTimestamp 

Zeitpunkt der Übergabe der Nachricht an den JMS-Provider in 
Millisekunden (Typ long). 



JMSExpiration 

Zeitpunkt des Verfalls einer Nachricht in Millisekunden (Typ 
long). Dieser kann mit der MassageProducer-Methode setTimeToLive 
(siehe oben) bestimmt werden. 
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Queueinfo 



import javax.jms.*; 
import javax.naming.*; 
import java.util .Enumeration; 
import java.util. Date; 

public dass Queueinfo { 

private static final String DESTINATION = "queue/myQueuel"; 

private static final String USER = "guest"; 

private static final String PASSWORD = "guest"; 

private QueueConnection Connection; 

private QueueSession session; 

private QueueBrowser browser; 

public Queueinfo () throws NamingException, JMSException ( 
Context ctx = new InitialContext ( ) ; 

QueueConnectionFactory factory = 

(QueueConnectionFactory ) ctx . lookup ( "ConnectionFactory" ) ; 
Queue queue = (Queue) ctx. lookup (DESTINATION) ; 

Connection = factory . createQueueConnection (USER, PASSWORD) ; 
session = Connection . createQueueSession ( 
false, Session. AUTO_ACKNOWLEDGE ) ; 

// QueueBrowser erzeugen 

browser = session. createBrowser (queue) ; 

Connection. Start () ; 

} 



public void list ( ) throws JMSException { 

Enumeration e = browser . getEnumeration ( ) ; 

Massage message; 
int ent = 0; 

while (e.hasMoreElements () ) { 
ent+t; 

message = (Massage) e . nextElement ( ) ; 

System. out .print (ent + " . " ) ; 

System. out .printin ("YtMessagelD: " + message. getJMSMessagelD ()) ; 
System. out .printin ("YtTimestamp: " + 
new Date (message . get JMSTimestamp ())); 

System. out .printin ("\tPriority: " + message . get JMSPriority ()) ; 
long expiration = message . get JMSExpiration ( ) ; 
if (expiration == 0) 

System. out. printin ("YtExpiration: 0") ; 
eise 

System. out. printin ("YtExpiration: " + new Date (expiration) ) ; 
System, out .printin ( ) ; 




public void closed throws JMSException { 
browser . close () ; 
session. closeO ; 

Connection . close ( ) ; 
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public static void main (String [] args) throws Exception { 
Queueinfo info = new Queueinfo ( ) ; 
info.list () ; 
info.closeO ; 



} 



8.3 Das Request-Reply-Modell 

Ein Spezialfall des Point-to-Point-Modells ist das Request-Reply- 
Modell, das eine synchrone Kommunikation zwischen Sender 
und Empfänger simuliert. Der Sender wartet solange, bis die 
Antwortnachricht eintrifft. Elierzu wird eine temporäre Warte- 
schlange für die Antwortnachricht genutzt. Diese wird vom Sen- 
der für die Dauer der Kommunikation erzeugt und dem Empfän- 
ger über den Nachrichten-Header jMSRepiyTo (Typ Destination) 
mitgeteilt. 




MOM-Server 



Bild 8 3 

Request-Reply- 

Modell 



Das Interface TemoraryQueue ist Subinterface von Queue und enthält 
die Lösch-Methode 

void delete() throws JMSException 



Die folgende QueueSession-Methode erzeugt eine temporäre War- 
teschlange: 

TenporaryQueue createTertporaryQueue ( ) throws JMSException 



Programm 8.3 bietet einen Echo-Dienst, der bereits aus vorher- Programm 83 
gehenden Kapiteln bekannt ist. 
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EcboClient 



import javax.jms.*; 
import javax.naming.*; 

public dass EchoClient { 

private static final String DESTINATION = "queue/myQueuel"; 
private static final String USER = "guest"; 
private static final String PASSWORD = "guest"; 

private String text; 

private QueueConnectionFactory factory; 
private Queue queue; 

public EchoClient (String text) throws NamingException, 
JMSException { 

this.text = text; 

Context ctx = new InitialContext ( ) ; 
factory = (QueueConnectionFactory) ctx.lookup( 
"ConnectionFactory " ) ; 
queue = (Queue) ctx. lookup (DESTINATION) ; 



public void process ( ) throws JMSException { 

QueueConnection Connection = null; 

QueueSession session = null; 

TemporaryQueue tempQueue = null; 

QueueSender sender = null; 

QueueReceiver receiver = null; 

try { 

Connection = factory. createQueueConnection (USER, PASSWORD); 
session = Connection. createQueueSession ( 
false, Session. ÄUTO_ACKNOWLEDGE) ; 

// temporäre Queue für die Antwort erzeugen 
tempQueue = session. createTemporaryQueue () ; 

sender = session. createSender (queue) ; 
receiver = session. createReceiver (tempQueue) ; 

Connection . Start () ; 

TextMessage request = session. createTextMessageO ; 

request . setText (text) ; 

request . set JMSReplyTo (tempQueue) ; 

sender . send ( request ) ; 

// auf Antwort warten 

TextMessage response = (TextMessage) receiver. receive () ; 
System. out .printin (response. getText () ) ; 

} 

finally { 

sender . close ( ) ; 
receiver . close () ; 
tempQueue . delete ( ) ; 
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Session . close ( ) ; 
Connection . close ( ) ; 




public static void main (String [] args) throws Exception { 
String text = args[0]; 

EchoClient Client = new EchoClient (text) ; 

Client .process () ; 



} 



import javax.jms.*; 
import javax.naming. *; 

public dass EchoServer { 

private static final String DESTINATION = "queue/myQueuel"; 
private static final String USER = "guest"; 
private static final String PASSWORD = "guest"; 

private QueueConnectionFactory factory; 
private Queue queue; 

public EchoServer () throws NamingException, JMSException { 
Context ctx = new InitialContext ( ) ; 
factory = (QueueConnectionFactory) ctx.lookup( 
"ConnectionFactory" ) ; 
queue = (Queue) ctx. lookup (DESTINATION) ; 

} 



public void process ( ) throws JMSException { 

QueueConnection Connection = factory . createQueueConnection ( 
USER, PASSWORD); 

QueueSession session = Connection . createQueueSession ( 
false, Session. ÄUTO_ACKNOWLEDGE) ; 

QueueReceiver receiver = session. createReceiver (queue) ; 
Connection. Start () ; 

System. out .printin ("EchoServer gestartet ..."); 
while (true) { 

TextMessage request = (TextMessage) receiver. receive () ; 
String text = request. get Text () ; 

Queue tempQueue = (Queue) request. get JMSReplyToO ; 
TextNfessage response = session. createTextMessageO ; 
response . set Text (text) ; 

QueueSender sender = session . createSender (tempQueue) ; 
sender . send (response) ; 




public static void main (String [] args) throws Exception { 
EchoServer Server = new EchoServer () ; 

Server .process () ; 



} 



EchoServer 
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Natürlich kann zur Verbesserung der Performance die clientspe- 
zifische Verarbeitung einer empfangenen Nachricht in einem 
eigenen Thread erfolgen (siehe Aufgabe 2). 



8.4 Das Publish-Subscribe-Modell 

Beim Publish-Subscribe-Modell ( Pub/Sub ) sendet der Publisher 
Nachrichten zu einem bestimmten Thema ( Topic ), die vom Ver- 
mittler (MOM-Server) in einer entsprechenden Warteschlange 
eingestellt werden. Subscriber können beim Vermittler ein be- 
stimmtes Thema abonnieren. Alle Subscriber erhalten dann die 
Nachrichten, die zu diesem Thema veröffentlicht wurden. Im 
Unterschied zum P2P-Modell erhalten sie aber nur die Nachrich- 
ten, die während ihrer aktiven Verbindung mit dem Vermittler 
versandt wurden. Publisher und Subscriber sind vollständig un- 
abhängig voneinander. 

Es können jedoch auch dauerhafte Abonnements eingerichtet 
werden. Ein dauerhafter Subscriber erhält dann später auch die 
Nachrichten zu einem Thema, die veröffentlicht wurden, wäh- 
rend er keine Verbindung zum Vermittler hatte (siehe Kapitel 
8.5). 



Bild 8.4. 

Pi i b/Su b-Modell 




Analog zum Nachrichtenziel Queue in Kapitel 8.2 existieren die 
folgenden Interfaces: 

Topic (Subinterface von Destination) 

TopicConnectionFactory (Subinterface von ConnectionFactory) 
TopicConnection (Subinterface von Connection) 

TopicSession (Subinterface von Session) 

TopicPublisher (Subinterface von MessageProducer) 

TopicSubscriber (Subinterface von MessageConsumer) 
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TopicConnectionFactory-Methode : 

TopicConnection createTcpioConnection (String user, String password) 
throws JMSException 



TopicConnection-Methode : 

TopicSession createTcpicSession ( 

boolean transacted, int acknowledgeMode) throws JMSException 



TopicSession-Methoden: 

TopicPüblisher createPublisher (Topic topic) throws JMSException 
TopicSubscriber createSubscriber (Topic topic) throws JMSException 



TopicPublisher-Methode : 

void publish (Message message) throws JMSException 



Das folgende Programmbeispiel nutzt den Nachrichtentyp Map- MapMessage 
Message. Eine solche Nachricht besteht im Nachrichtenrumpf aus 
Schlüssel-Wert-Paaren. Der Schlüssel ist vom Typ string, der Wert 
vom Typ boolean, byte, short, char, int, long, float, double, String 
oder byte [ ] . 



Zu jedem Datentyp existieren die get- und sef-Methoden: 

void setXxx(xxx value) throws JMSException 
xxx get^xx-(String name) throws JMSException 

Für den Typ byte[] heißen die Methoden setßytes und 
getBytes. 



Eine MapMessage wird mit der folgenden Session-Methode erzeugt: 

MapMessage createMapMsssage ( ) throws JMSException 



Der Publisher in Programm 8.4 veröffentlicht in regelmäßigen Programm 8.4 
Abständen Messdaten mit Zeit- und Wertangabe. Subscriber wer- 
ten diese Messdaten aus. 



Zunächst muss das Thema (Topic) für JBoss konfiguriert werden. 

Die XML-Datei myTopicl -Service. xml enthält die erforderlichen Topic bereitstellen 
Angaben. Der Topic-Name ist myTopicl. Zugriff haben alle Be- 
nutzer mit der Rolle guest. 
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Inhalt von myTopicl -Service. xmh 

<?xml version="1.0" encoding="UTF-8 " ?> 

<server> 

<mbean code="org . jboss . mq . Server . jmx . Topic" 

name=" jboss . mq . destination : service=Topic , name=myTqpicl " > 
<depends optional-attribute-name="DestinationManager"> 
jboss .mq: service=DestinationManager 
</depends> 

<depends opt ional-att ribute-name=" SecurityManager " > 
jboss .mq: service=SecurityManager 
</depends> 

<attribute name= ,, SecurityConf"> 

<security> 

<role name="guest" read="true" write= n true"/> 
</security> 

</attribute> 

</mbean> 

</server> 



Publisher 



import javax . jms . *; 
irrport javax . naming . * ; 
import java.util.*; 
import java.text.*; 

public dass Publisher { 

private static final String DESTINATION = "topic/myTopicl"; 
private static final String USER = "guest"; 
private static final String PASSWORD = "guest"; 

private TopicConnectionFactory factory; 
private Topic topic; 

public Publisher () throws NamingException, JMSException { 
Context ctx = new InitialContext ( ) ; 
factory = (TopicConnectionFactory) ctx.lookup( 
"ConnectionFactory" ) ; 
topic = (Topic) ctx. lookup (DESTINATION) ; 

} 



public void process ( ) throws JMSException { 

TopicConnection connection = factory . createTopicConnection ( 
USER, PASSWORD) ; 

TopicSession session = connection. createTopicSession ( 
false, Session. AUTO_ACKNOWLEDGE) ; 

TopicPublisher publisher = session. createPublisher (topic) ; 

SimpleDateFormat formatter = new SimpleDateFormat ("HH:rrm:ss") ; 
while (true) { 

String time = formatter. format (new DateQ); 
double value = Math . random ( ) * 100; 

MapMessage message = session . createMapMessage () ; 
message . setString ( "Time" , time) ; 
message . setDouble ( "Value " , value ) ; 
publisher. publish (message) ; 
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try { 

Thread.sleep(2000) ; 

} 

catch (InterruptedException e) { } 




public static void main (String [] args) throws Exception { 
Publisher pub = new Publisher ( ) ; 
pub.process () ; 



} 



iirport javax.jms.*; 
import javax.naming. *; 

public dass Subscriber implements MessageListener { 

private static final String DESTINATION = "topic/myTopicl"; 
private static final String USER = "guest"; 
private static final String PASSWORD = "guest"; 

private TopicConnectionFactory factory; 
private Topic topic; 
private TopicConnection Connection; 
private TopicSession session; 
private TopicSubscriber subscriber; 

public Subscriber () throws NamingException, JMSException { 
Context ctx = new InitialContext ( ) ; 
factory = (TopicConnectionFactory) ctx.lookup( 
"ConnectionFactory" ) ; 
topic = (Topic) ctx. lookup (DESTINATION) ; 

} 



public void subscribeO throws JMSException { 

Connection = factory . createTopicConnection (USER, PASSWORD); 
session = connection . createTopicSession ( 
false, Session. ÄUTO_ACKNOWEEDGE) ; 
subscriber = session . createSubscriber (topic) ; 
subscriber . setMessageListener (this) ; 
connection. Start () ; 



public void close ( ) throws JMSException { 
subscriber. close () ; 
session. close () ; 
connection . close ( ) ; 



Subscriber 
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Test 



public void onMessage (Message message) { 
try { 

if (message instanceof MapMsssage) { 

MapMassage mapMessage = (MapMessage) message; 
System. out. printin (mapMessage.getStringC'Time") ) ; 
System, out. printin (mapMessage. getDoubleC'Value") ) ; 
System . out . printin ( ) ; 



catch (JMSException e) < 
System. err .printin (e) ; 

} 



public static void main (String [ ] args) throws Exception { 
long time = Long.parseLong(args [0] ) ; 

Subscriber sub = new Subscriber () ; 
sub . subscribe ( ) ; 

Thread. sleep (time) ; 
sub.close () ; 




java -cp build; % JBOSSCLIENT_PATH% Publisher 
java -cp build; %JBOSSCLIENT_PATH% Subscriber 60000 



Mehrere Subscriber können in verschiedenen DOS-Fenstern mit 
unterschiedlichen Aktivitätszeiten (im Beispiel 60 Sekunden) ge- 
startet werden. 



8.5 Dauerhafte Subscriber 

Wie bereits in Kapitel 8.4 erwähnt erhält ein Subscriber stan- 
dardmäßig nur solche Nachrichten, die an ein Topic geschickt 
werden, während er eine Verbindung zum MOM-Server hat. Ein 
dauerhafter Subscriber kann auch nachträglich Nachrichten abru- 
fen, die geschickt wurden, während er inaktiv war. Hierzu muss 
eine Subskription eindeutig identifiziert werden können. 

Zur Identifizierung einer Subskription dienen 

• die Client-Identifikation der Verbindung und 

• ein Name, der innerhalb dieser Client-Identifikation die Sub- 
skription eindeutig identifiziert. 
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Die Client-Identifikation wird mit der folgenden TopicConnection- 
Methode gesetzt, unmittelbar nachdem das Topicconnection-Objekt 
erzeugt wurde: 

void setClientID (String clientID) throws JMSException 



Die Topicsession-Methode 

TopicSubscriber createDurableSubscriber (Topic topic, String name) 
throws JMSException 

erzeugt einen dauerhaften Subscriber. name ist der oben erwähnte 
Subskriptionsname. 



Mit der TopicSession-Methode 

void unsubscribe (String name) throws JMSException 

kann sich der Subscriber vom Server abmelden. 



Die TopicConnection-Methode 

String getClientID ( ) throws JMSException 

liefert die eindeutige Client-Identifikation der Verbindung. 



Programm 8.5 demonstriert Anmeldung, Abruf von Nachrichten Programm 8.5 
und Abmeldung eines dauerhaften Subscribers. 

Die XML-Datei zur Konfiguration des Topics für JBoss muss ge- 
ändert werden. Die Rolle guest muss das Recht für eine 
dauerhafte Subskription erhalten: Attribut create="true". 



Inhalt von myTopic2-service.xml: 

<?xml version="1.0" encoding= n UTF-8"?> 

<server> 

<rribean code="org. jboss .mq. Server . jmx . Topic" 

name=" jboss . mq . destination : service=Topic, name=myTopic2 " > 
<depends optional-attribute-name="DestinationManager"> 
jboss .mq: service=DestinationManager 
</depends> 

<depends opt ional-att ribut e-name= " Secur ityManager " > 
jboss .mq: service=Secur ityManager 
</depends> 

<attribute name="SecurityConf"> 

<security> 

<role name="guest" read="true" write="true" create="true"/> 
</ security> 

</attribute> 

</mbean> 

</server> 
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Publisher 



Subscriber 



import javax.jms.*; 
import javax . naming . * ; 

public dass Publisher { 

private static final String DESTINATION = "topic/myTopic2"; 
private static final String USER = "guest"; 
private static final String PASSWORD = "guest"; 

private TopicConnectionFactory factory; 
private Topic topic; 

public Publisher () throws NamingException, JMSException ( 
Context ctx = new InitialContext ( ) ; 
factory = (TopicConnectionFactory) ctx.lookupt 
"ConnectionFactory " ) ; 
topic = (Topic) ctx.lookup (DESTINATION) ; 

} 



public void publish (String text) throws JMSException { 

TopicConnection Connection = factory . createTopicConnection ( 
USER, PASSWORD) ; 

TopicSession session = Connection. createTopicSession( 
false, Session. ÄUTO_ÄCKNOWLEDGE) ; 

TopicPublisher publisher = session. createPublisher (topic) ; 

TextMessage message = session . createTextMessage ( ) ; 
message . setText (text) ; 
publisher .publish (message) ; 

publisher . close () ; 
session. closeO ; 

Connection . close ( ) ; 



public static void main (String [ ] args) throws Exception { 
String text = args[0]; 

Publisher pub = new Publisher ( ) ; 
pub. publish (text) ; 




import javax.jms.*; 
import j avax. naming.*; 

public dass Subscriber { 

private static final String DESTINATION = "topic/myTopic2"; 
private static final String USER = "guest"; 
private static final String PASSWORD = "guest"; 

private TopicConnectionFactory factory; 
private Topic topic; 
private TopicConnection Connection; 
private TopicSession session; 
private TopicSubscriber subscriber; 
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public Subscriber () throws NamingException, JMSException { 
Context ctx = new InitialContext ( ) ; 
factory = (TopicConnectionFactory) ctx.lookup( 
"ConnectionFactory" ) ; 
topic = (Topic) ctx. lookup (DESTINATION) ; 



public void subscribe (String id, String name) throws JMSException { 
Connection = factory. createTopicConnection (USER, PASSWORD) ; 
Connection. setClientID (id) ; 

Session = connection . createTopicSession ( 
false, Session. ÄÜTO_ACKNOWLEDGE) ; 
subscriber = session . createDurableSubscriber (topic, name) ; 
subscriber. close () ; 
session. closeO ; 
connection. close () ; 



public void unsubscribe (String id, String name) 
throws JMSException { 

connection = factory. createTopicConnection (USER, PASSWORD); 
connection. setClientID (id) ; 
session = connection . createTopicSession ( 
false, Session. ÄUTO_ACKNOWLEDGE) ; 
session. unsubscribe (name) ; 
session. closeO ; 
connection . close ( ) ; 



public void receive (String id, String name, long timeout) 
throws JMSException ( 

connection = factory. createTopicConnection (USER, PASSWORD); 
connection. setClientID (id) ; 
session = connection . createTopicSession ( 
false, Session. ÄUTO_ACKNOWI£DGE) ; 
subscriber = session . createDurableSubscriber (topic, name) ; 
connection. Start () ; 

Message message; 

while ((message = subscriber. receive (timeout) ) != null) { 
if (message instanceof TextMessage) { 

TextMessage textMessage = (TextMessage) message; 

System, out . printin (textMessage . getText ( ) ) ; 




subscriber. close () ; 
session. closeO ; 
connection. close () ; 
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public static void main (String [ ] args) throws Exception { 

String Option = args[0]; 

String id = args[l]; 

String name = args [2]; 

Subscriber sub = new Subscriber () ; 

if (Option. equals ("subscribe") ) < 
sub . subscribe ( id, name ) ; 

} 

eiseif (Option . equals ( "unsubscribe" ) ) { 
sub.unsubscribe (id, name) ; 

} 

eiseif (Option. equals ("receive") ) < 
long timeout = Long.parseLong(args [3] ) ; 
sub. receive (id, name, timeout); 




Test Anmelden: 

java -cp build; % JBOSSCLIENT_PATH% Subscriber subscribe 100 subl 



Nachricht publizieren: 

java -cp build; %JBOSSCLIENT_PATH% Publisher Hallo 



Nachrichten abrufen: 

java -cp build; %JBOSSCLIENT_PATH% Subscriber receive 100 subl 5000 

Ausgabe: 

Hallo 



Abmelden: 

java -cp build; %JBOSSCLIENT_PATH% Subscriber unsubscribe 100 subl 



8.6 Aufgaben 
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8.6 Aufgaben 

1. Entwickeln Sie auf Basis des P2P-Modells einen Zeitangabe- 
Service, der jede Minute die aktuelle Uhrzeit übermittelt. Ein 
Client soll diese Zeitangabe ausgeben. 

2. Entwickeln Sie eine Variante zu Programm 8.3, in der die 
clientspezifische Verarbeitung einer empfangenen Nachricht 
in einem eigenen Threacl ausgeführt wird. 

3. Implementieren Sie auf Basis des Pub/Sub-Modells ein ein- 
faches Chat-Programm. Die Bedienung soll über Komman- 
dozeilen im DOS-Fenster erfolgen. Damit Nachrichten so- 
wohl gesendet als auch empfangen werden können, muss 
das Programm einen TopicPublisher und einen Topic- 
Subscriber enthalten. 



Das Projektverwaltungswerkzeug Ant 



Ant ist ein Werkzeug, mit dem Quellcode zusammengestellt, 
bearbeitet, übersetzt und Programme ausgeführt werden können. 
Es ist insbesondere für die Steuerung umfangreicher Erzeu- 
gungsprozesse im Java-Umfeld geeignet. 



Unter der Adresse http://ant.apache.org befinden sich die Seiten Installation 
zum Download der Binärdistribution inklusive Dokumentation. 

In diesem Buch wird die Version 1.7.0 genutzt. 

Die Archivdatei apache-ant-1 . 7.0RCl-bin.zip kann in einem 
beliebigen Verzeichnis (z.B. CA) entpackt werden. Anschließend 
müssen Umgebungsvariablen (z.B. bei Windows über System in 
der Systemsteuerung) gesetzt werden: 

ÄNT_HCME = C:\apache-ant-l. 7. 0RC1 
JAVA_H0ME = <Java-Installationsverzeichnis> 

PATH = % JAVA_HCME% \bin ; %ANT_HCiyiE%\bin; . . . 



Ant wird über eine XML-Datei build.xml gesteuert. Dieses so Ein Beispiel 
genannte Buildfile enthält ein Projekt, in dem in Targets die ein- 
zelnen Arbeitsschritte ( Tasks ) zusammengefasst sind. 

<project name="Demo-Projekt" default= ,, mkeJar" basedir=" . "> 

<property name="version" value="1.0" /> 

<property name="src" value= n src"/> 

<property name="build" value= ,, build"/> 

<property name="lib" value= ,, lib"/> 

<property name=" jarname" value="demo-$ {version} . jar"/> 

<target name="prepare"> 

<mkdir dir="${build} "/> 

<mkdir dir="${lib} "/> 

</target> 

<target name="clean" de s er ipt ion= "Auf raeuunen " > 

<delete dir="${build} "/> 

<delete dir="${lib}"/> 

</target> 

<target name="corrpile" depends="prepare n description= ,, Conpilieren ,, > 

<javac srcdir="${src}" destdir= n ${build}"/> 

</target> 

<target name="makeJar" depends= n conpile n 
description="Jar-Datei erzeugen"> 

< jar jarfile="$ {lib} /demo-$ {version} . jar" basedir="$ {build} "/> 

</target> 
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<target name="start" description="Anwendung starten"> 
<java classname="Demo" fork="yes"> 

<classpath> 

<pathelement location=" $ { lib } /$ ( jamame } " /> 
</classpath> 

</java> 

</target> 

</project> 



Welche Targets zur Verfügung stehen, kann durch das folgende 
Kommando angezeigt werden (Aufruf in dem Verzeichnis, das 
build.xml enthält): 

ant -p 



Ausgabe: 

Buildfile: build.xml 

Main targets: 

clean Aufraeumen 
cctnpile Compilieren 
makeJar Jar-Datei erzeugen 
Start Anwendung starten 
Default target: makeJar 



Targets können von anderen Targets abhängig sein (Attribut 
depends). So hängt z.B. das Target compile vom Target prepare , 
das Target makeJar vom Target compile ab. 

Der Aufruf von 

ant makeJar 

oder auch nur ant, da makeJar das Default-Target ist (siehe 
project- Tag), führt dazu, dass zunächst die Verzeichnisse biiild 
und lib angelegt (Target prepare ), dann die Sourcen compiliert 
werden (Target compile') und schließlich die jar-Datei erzeugt 
wird. 



Ausgabe: 

Buildfile: build.xml 
prepare : 

[mkdir] Created dir: D:\MKJava\MKCSJava\Ant\build 
[mkdir] Created dir: D:\MKJava\MKCSJava\Ant\lib 



compile : 

[javac] Compiling 1 source file to D:\MKJava\MKCSJava\Ant\build 
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make Jar : 

[jar] Building jar: D:\MKJava\MKCSJava\Ant\lib\demo-1.0. jar 

BUILD SUCCESSFUL 
Total time: 10 seconds 

Zu Beginn der Build-Datei werden Variablen xxx, so genannte 
Properties, gesetzt (z.B. konkrete Verzeichnisnamen). Auf diese 
wird später mit ${xxx} Bezug genommen. 

"ant start" startet das Programm Demo. 

"ant clean" stellt den Anfangszustand wieder her. 

Eine vollständige Liste aller Elemente und insbesondere der zur 
Verfügung stehenden Tasks befindet sich in der Online-Doku- 
mentation von Ant. 




Programmverzeichnis 



Programm 1.1 


Einfacher Client und Server (lokal) 


Programm 1.2 


Entkoppelter Client und Server (lokal) 


Programm 1.3 


RMI-Client- und -Server 


Programm 1.4 


IP-Adresse und Hostname des lokalen Rechners 


Programm 1.5 


Ermittlung der IP-Adresse 


Programm 2.1 


Ausgabe einiger DB-Metadaten 


Programm 2.2 


Bücherliste 


Programm 2.3 


Bücherliste mit Angabe des Verlags 


Programm 2.4 


Suche nach einem bestimmten Buchtitel 


Programm 2.5 


Neue Tabellen anlegen 


Programm 2.6 


Daten importieren 


Programm 2.7 


Daten exportieren 


Programm 2.8 


Lagerbestand ändern 


Programm 2.9 


Frontend für SQL-Datenbanken 


Programm 2.10 


Bilder importieren 


Programm 2.11 


Bilder exportieren 


Programm 2.12 


Navigation durch die Ergebnismenge 


Programm 2.13 


Änderungen in der Ergebnismenge 


Programm 2.14 


XML-Dokumente aus SQL-Abfragen erzeugen 


Programm 2.15 


Bücherliste (Stored Procedure) 


Programm 2.16 


Bestandsänderung (Stored Procedure) 


Programm 3-1 


UDP-Client und UDP-Server 


Programm 3-2 


Nur UDP-Pakete eines bestimmten Client empfangen 


Programm 3-3 


Online-Unterhaltung über UDP 


Programm 4.1 


TCP-Client und TCP-Server 


Programm 4.2 


Download-Programm 


Programm 4.3 


Chat-Programm 


Programm 4.4 


Klassen über das Netz laden 


Programm 4.5 


RPC selbst entwickelt 


Programm 4.6 


Einsatz eines Thread-Pools 
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Programmverzeichnis 



Programm 4.7 


Framework für TCP-Server 


Programm 5.1 


HTTP -Anfrage anzeigen 


Programm 5.2 


Einfacher File-Server 


Programm 5-3 


HTTP-Server für SQL-Abfragen 


Programm 5.4 


Mini-Webserver 


Programm 5.5 


Webseiten dynamisch erzeugen 


Programm 6.1 


Eine einfache XML-RPC-Anwendung 


Programm 6.2 


Client und Server zum Testen der XML-RPC-Datentypen 


Programm 6.3 


Warenkorb als Array von Arrays 


Programm 6.4 


Umgang mit komplexen Datenstrukturen 


Programm 6.5 


Dynamischer Proxy 


Programm 6.6 


Filterung von IP-Adressen 


Programm 6.7 


Einsatz von Apache Tomcat 


Programm 6.8 


Basic Authentication 


Programm 6.9 


Nutzung von SSL 


Programm 6.10 


Nutzung einer Erweiterung in Apache XML-RPC 


Programm 7.1 


Eine einfache RMI-Anwendung 


Programm 7.2 


Liste aller in der Registry gebundenen Namen 


Programm 7.3 


Transport by reference 


Programm 7.4 


Mobile Agenten 


Programm 7.5 


Ein Message-Dienst mit Callback-Funktion 


Programm 7.6 


Java RMI over IIOP 


Programm 8.1 


Nachrichten senden und empfangen 


Programm 8.2 


Informationen über die Warteschlange abfragen 


Programm 8.3 


Synchrone Kommunikation zwischen Sender und Empfänger 


Programm 8.4 


Themen abonnieren 


Programm 8.5 


Dauerhafte Abonnements 




Aufgabenverzeichnis 



Aufgabe 1.1 
Aufgabe 1.2 


Verbesserte Version von Programm 1.5 
Grafische Anzeige von IP-Adresse und Hostname 


Aufgabe 2.1 
Aufgabe 2.2 
Aufgabe 2.3 
Aufgabe 2.4 
Aufgabe 2.5 


Datenmodell erweitern 
Bestelldaten erfassen 
Verfügbarkeit prüfen 

Daten zwischen unterschiedlichen DBMS transferieren 
Variante zu Programm 2.6 


Aufgabe 3-1 
Aufgabe 3-2 
Aufgabe 3-3 


UDP-Server, der die aktuelle Systemzeit liefert 
UDP-Server für Messwerte 
UDP-Server, der Zitate liefert 


Aufgabe 4.1 
Aufgabe 4.2 
Aufgabe 4.3 
Aufgabe 4.4 
Aufgabe 4.5 


Einfacher Text-Server 

Server, der die aktuelle Systemzeit liefert 

Begrenzung der Anzahl gleichzeitig aktiver Threads 

GUI-Client zur Dateiübertragung 

RPC-Verfahren für SQL-Abfragen 


Aufgabe 5.1 
Aufgabe 5.2 
Aufgabe 5.3 
Aufgabe 5.4 


Download über HTTP 
Variante zu Aufgabe 5.1 
Eine Bücherliste dynamisch erzeugen 
Mini-Webserver mit Thread-Pool 


Aufgabe 6.1 
Aufgabe 6.2 
Aufgabe 6.3 
Aufgabe 6.4 
Aufgabe 6.5 


Message-Dienst 
Adressen verwalten 

GUI-Client für die Suche nach Adressen 
Eintritts- und Austrittszeiten zentral erfassen 
Ein PHP-Client für Aufgabe 6.2 


Aufgabe 7.1 
Aufgabe 7.2 
Aufgabe 7.3 


Ein Time-Server 

Datenbankabfrage über RMI 

Ein Agent, der Fakultäten berechnet 
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Aufgabenverzeichnis 



Aufgabe 7.4 
Aufgabe 7.5 
Aufgabe 7.6 



Ein Applet als RMI-Client 
Chat-Programm auf der Basis von RMI 
Ein zur Laufzeit konfigurierbarer RMI-Server 



Aufgabe 8.1 
Aufgabe 8.2 
Aufgabe 8.3 



Ein P2P-Zeitangabe-Service 

Eine Variante zu Programm 8.3 

Ein Chat-Programm auf Basis des Pub/Sub-Modells 




Internet-Quellen 



1 . Beispielprogramme und Lösungen zu den Aufgaben 

Den Zugang zu den Zusatzmaterialien finden Sie auf der Website des Verlags 

www . vieweg . de 

direkt neben den bibliographischen Angaben zu diesem Buch. 

Extrahieren Sie nach dem Download alle Dateien des ZIP-Archivs unter Ver- 
wendung der relativen Pfadnamen in ein von Ihnen gewähltes Verzeichnis Ihres 
Rechners. 

Die Distribution enthält die Java-GUI-Anwendung SQLClient, mit der beliebige 
SQL-Anweisungen für relationale Datenbanken ausgeführt werden können, so- 
fern ein JDBC-Treiber für das jeweilige Datenbankmanagementsystem vorliegt. 



2. Java Standard Edition 

http : // java . sun. ccm/ javase/ 

Hier finden Sie die neueste Version zur Java Standard Edition (Java SE) für di- 
verse Plattformen sowie die zugehörige Dokumentation. Beachten Sie die für Ih- 
re Plattform zutreffende Installationsanweisung. 



3. Java-Entwicklungsumgebungen und -Editoren 

J ava-Editor : http : //lernen . bildung . hessen . de/informatik/ javaeditor/index . htm 
Eclipse: http://www.eclipse.org 

JCreator: http://www.jcreator.com 

4. Projektverwaltungswerkzeug Ant 

http : / /ant . apache . org 



5. MySQL Community Server, GUI-Tools, Connector/J 

http : / / www . my sql . de 



6. Apache Derby 



http : / /db . apache . org/derby/ 
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Internet-Quellen 



7. Apache XML-RPC 

http : / /ws . apache . org/xmlrpc/ 

8. XML-RPC-Library für PHP 

http: //sourceforge . net/pro jects/phpxmlrpc/ 



9. JMS 

http : / / j ava . sun . com/products / jms / 

10. Webserver, Application Server 

Apache HTTP Server: http://httpd.apache.org 

JBoss Application Server: http://www.jboss.org 

Apache Tomcat: http://tcmcat.apache.org 

11. Apache ActiveMQ 

http : / /www . act ivemq . org 



12. Protokoll-Spezifikationen 



UDP: 

TCP: 

Ports: 

HTTP 1.0: 

HTTP 1.1: 

MIME: 

Base64: 

Basic Authentication: 
XML-RPC: 



http : //www . ietf . org/ rf c/rf c7 68 . txt 

http : //www . ietf . org/ rf c/rf c7 93 . txt 

http : / /www . iana . org/assignments/port-nurribers 

http : //www . ietf . org/rf c/rf cl 945 . txt 

http : //www . ietf . org/ rf c/rf c2616 . txt 

http : //www . ietf . org/ rf c/rf cl52 1 . txt 

http : //www . ietf . org/rf c/rf c2045 . txt 

http : //www . ietf . org/rf c/rf c2 617 . txt 

http : / /www . xmlrpc . com 



Literaturhinweise 



In den Vorbemerkungen des ersten Kapitels wurden die zum Verständnis nötigen 
Vorkenntnisse der Leserinnen und Leser zu Java, Datenbanken, SQL usw. aufgeführt. 

Die folgenden Bücher sind für eine Einführung in diese Themen bzw. eine Ver- 
tiefung gut geeignet. 



1. Java-Grundlagen 

• Abts, D.: Grundkurs Java. Von den Grundlagen bis zu Datenbank- und Netz- 
anwendungen. Vieweg, 4. Auflage 2004 

• Fischer, G.; Wolff von Gudenberg, J.: Programmieren in Java 1.5. Springer, 1. 
Auflage 2005 

• Harold, E. R.: Java I/O. O’ Reilly, 2. Auflage 2006 

• Heinzl, S.; Mathes, M.: Middleware in Java. Vieweg, 1. Auflage 2005 (Kapitel 
2: Nebenläufigkeit in Java) 

• Oaks, S.; Wong, H.: Java Threads. O’ Reilly, 3- Auflage 2004 

• Oechsle, R.: Parallele Programmierung mit Java Threads. Fachbuchverlag 
Leipzig, 1. Auflage 2001 

• Wolmeringer, G.; Klein, T.: Profikurs Eclipse 3- Vieweg, 2. Auflage 2006 



2. Ant 

• Edlich, S.; Staudemeyer, J.: Ant - kurz & gut. O’ Reilly, 2. Auflage 2006 

• Matzke, B.: Ant. Eine praktische Einführung in das Java-Build-Tool. Dpunkt 
Verlag, 2. Auflage 2005 



3. Verteilte Systeme, Software-Architekturen 

• Bengel, G.: Verteilte Systeme. Vieweg, 3- Auflage 2004 

• Dustdar, S.; Gail, H.; Hauswirth, M.: Software-Architekturen für Verteilte Sys- 
teme. Springer, 1. Auflage 2003 

• Hammerschall, U.: Verteilte Systeme und Anwendungen. Pearson Studium, 1. 
Auflage 2005 



4. lnternet-/Web-Technologien 

• Avci, O.; Trittmann, R.; Mellis, W.: Web-Programmierung. Vieweg, 1. Auflage 
2003 
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5. XML 
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7. JDBC 
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• Heinzl, S.; Mathes, M.: Middleware in Tava. Vieweg, 1. Auflage 2005 (Kapitel 

6 ) 

• Langner, T.; Reiberg, D.: J2EE und JBoss. Hanser Fachbuchverlag, 1. Auflage 
2005 (Kapitel 7) 

• Pitt, E.; McNiff, K.: java.rmi, The Remote Method Invocation Guide. Addison- 
Wesley Longman, 2001 



11. JMS 

• Bengel, G.: Verteilte Systeme. Vieweg, 3- Auflage 2004 (Kapitel 3-1-2) 
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